@softtynet/zca-js 2.3.5 → 2.3.7

package/dist/cjs/models/OAMessage.cjs

@@ -0,0 +1,375 @@
+'use strict';
+
+function safeJsonParse(input) {
+    if (input === null || input === undefined)
+        return undefined;
+    if (typeof input === "object")
+        return input;
+    if (typeof input !== "string")
+        return undefined;
+    const trimmed = input.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveHighlightValue(item) {
+    if (typeof item === "string")
+        return item;
+    if (typeof item === "number")
+        return String(item);
+    if (item && typeof item === "object") {
+        if (typeof item.dpn === "string" && item.dpn.length > 0)
+            return item.dpn;
+        if (typeof item.text === "string" && item.text.length > 0)
+            return item.text;
+        if (typeof item.value === "string" && item.value.length > 0)
+            return item.value;
+        if (typeof item.uid === "string" && item.uid.length > 0)
+            return item.uid;
+        if (typeof item.ts === "number")
+            return new Date(item.ts).toISOString();
+    }
+    return "";
+}
+/**
+ * Điền các biến `%1$s`, `%2$s`... và `$1$s`, `$2$s`... trong mẫu chuỗi thông báo Zalo OA
+ * theo chuẩn hàm `_renderItemReplace` trên Zalo PC.
+ */
+function formatOAHighlightText(templateText, highLightsV2) {
+    if (!templateText || typeof templateText !== "string")
+        return "";
+    if (!Array.isArray(highLightsV2) || highLightsV2.length === 0)
+        return templateText;
+    let result = templateText;
+    highLightsV2.forEach((item, index) => {
+        const val = resolveHighlightValue(item);
+        const idx1 = index + 1;
+        result = result.replaceAll(`%${idx1}$s`, val).replaceAll(`$${idx1}$s`, val);
+    });
+    return result;
+}
+/**
+ * Bóc tách cấu hình chân trang tương tác `footerv2` / `footer` của tin nhắn Zalo OA
+ * (`footerList`, `canForward`, `type`).
+ */
+function parseOAFooter(rawFooter) {
+    const parsed = safeJsonParse(rawFooter);
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const dataObj = safeJsonParse(parsed.data) ?? parsed;
+    const footerListRaw = Array.isArray(dataObj.footerList)
+        ? dataObj.footerList
+        : Array.isArray(parsed.footerList)
+            ? parsed.footerList
+            : [];
+    const footerList = footerListRaw
+        .map((entry) => safeJsonParse(entry))
+        .filter((entry) => Boolean(entry && typeof entry === "object"));
+    const canForwardRaw = dataObj.canForward ?? parsed.canForward;
+    const canForward = canForwardRaw === undefined ? true : Boolean(Number(canForwardRaw));
+    const type = typeof parsed.type === "number" ? parsed.type : undefined;
+    return {
+        type,
+        canForward,
+        footerList,
+        raw: parsed,
+    };
+}
+/**
+ * Kiểm tra xem một hồ sơ người dùng có phải là Zalo Official Account (OA) hay không.
+ * Theo chuẩn `isOA(profile)` trên Zalo PC: `profile.type > 0` hoặc có `profile.oaInfo`.
+ */
+function isOAProfile(profile) {
+    if (!profile || typeof profile !== "object")
+        return false;
+    if (typeof profile.type === "number" && profile.type > 0)
+        return true;
+    return Boolean(profile.oaInfo && typeof profile.oaInfo === "object");
+}
+/**
+ * Kiểm tra xem Zalo OA có tích vàng xác thực (Verified OA) hay không.
+ * Theo chuẩn `isOAVerifiedByInfo(profile)` trên Zalo PC (`@10388120`):
+ * Chuyển `profile.type` sang nhị phân (`Number(type).toString(2)`), kiểm tra độ dài >= 3 và ký tự index `2` là `"1"`.
+ * Ví dụ: `type = 7` (`"111"`) -> Verified OA; `type = 5` (`"101"`) -> Verified OA.
+ */
+function isOAVerified(profileOrType) {
+    const typeNum = typeof profileOrType === "number"
+        ? profileOrType
+        : typeof profileOrType?.type === "number"
+            ? profileOrType.type
+            : 0;
+    if (!(typeNum > 0))
+        return false;
+    const bin = Number(typeNum).toString(2);
+    return bin.length >= 3 && bin[2] === "1";
+}
+/**
+ * Kiểm tra xem tài khoản có phải là Zalo Bot hay không.
+ * Theo chuẩn `isZaloBotByInfo(profile)` trên Zalo PC (`@10388180`):
+ * Chuyển `profile.type` sang nhị phân (`Number(type).toString(2)`), kiểm tra độ dài >= 4 và ký tự đầu tiên là `"1"`.
+ */
+function isZaloBot(profileOrType) {
+    const typeNum = typeof profileOrType === "number"
+        ? profileOrType
+        : typeof profileOrType?.type === "number"
+            ? profileOrType.type
+            : 0;
+    if (!(typeNum > 0))
+        return false;
+    const bin = Number(typeNum).toString(2);
+    return bin.length >= 4 && bin[0] === "1";
+}
+/**
+ * Giải mã trạng thái chặn & Do-Not-Disturb (`oa_status`) của Zalo OA
+ * theo chuẩn `_getOAStatus` trên Zalo PC (`@1719856`).
+ */
+function parseOADnrStatus(oaStatus, fallbackIsBlocked) {
+    const parsed = safeJsonParse(oaStatus);
+    const isBlocked = parsed && "blocked" in parsed
+        ? Boolean(Number(parsed.blocked))
+        : Boolean(Number(fallbackIsBlocked ?? 0));
+    const enableDnr = parsed && "enable_dnr" in parsed ? Boolean(Number(parsed.enable_dnr)) : false;
+    const dnrType = parsed && typeof parsed.dnr_type === "number" ? parsed.dnr_type : null;
+    let dnrText = null;
+    if (parsed && parsed.dnr_string) {
+        if (typeof parsed.dnr_string === "string") {
+            dnrText = parsed.dnr_string;
+        }
+        else if (typeof parsed.dnr_string === "object" && parsed.dnr_string !== null) {
+            const langObj = parsed.dnr_string;
+            dnrText =
+                (typeof langObj.vi === "string" && langObj.vi) ||
+                    (typeof langObj.en === "string" && langObj.en) ||
+                    null;
+        }
+    }
+    return {
+        isBlocked,
+        enableDnr,
+        dnrType,
+        dnrText,
+        raw: parsed ?? oaStatus ?? null,
+    };
+}
+/**
+ * Chuẩn hóa dữ liệu hồ sơ Zalo Official Account (`getUserInfo` + `getBizAccount`) thành cấu trúc `OAProfileInfo` đồng nhất.
+ */
+function normalizeOAProfile(oaId, rawProfile, bizAccount) {
+    const prof = rawProfile ?? {};
+    const oaInfo = (safeJsonParse(prof.oaInfo) ?? null);
+    const biz = safeJsonParse(bizAccount?.biz) ?? {};
+    const type = typeof prof.type === "number" ? prof.type : oaInfo ? 1 : 0;
+    const dnrStatus = parseOADnrStatus(prof.oa_status, prof.isBlocked);
+    const pickFieldValue = (entry, fallback) => {
+        if (entry && typeof entry === "object" && typeof entry.value === "string" && entry.value.trim()) {
+            return entry.value.trim();
+        }
+        if (typeof fallback === "string" && fallback.trim()) {
+            return fallback.trim();
+        }
+        return "";
+    };
+    const cateObj = safeJsonParse(biz.cate);
+    const fallbackCategory = (typeof cateObj?.name === "string" && cateObj.name) ||
+        (typeof cateObj?.vi === "string" && cateObj.vi) ||
+        (typeof biz.cate === "string" ? biz.cate : "");
+    const displayName = (typeof prof.displayName === "string" && prof.displayName) ||
+        (typeof prof.zaloName === "string" && prof.zaloName) ||
+        oaId;
+    const zaloName = (typeof prof.zaloName === "string" && prof.zaloName) ||
+        displayName;
+    return {
+        oaId: String(prof.userId ?? oaId),
+        displayName,
+        zaloName,
+        username: typeof prof.username === "string" ? prof.username : String(prof.userId ?? oaId),
+        avatar: typeof prof.avatar === "string" ? prof.avatar : "",
+        cover: typeof prof.cover === "string" ? prof.cover : "",
+        globalId: typeof prof.globalId === "string" ? prof.globalId : "",
+        type,
+        isOA: isOAProfile({ type, oaInfo }),
+        isVerified: isOAVerified(type),
+        isZaloBot: isZaloBot(type),
+        isBlocked: dnrStatus.isBlocked,
+        isGroupedMsg: Number(oaInfo?.group_msg ?? 0) === 1,
+        description: (typeof oaInfo?.description === "string" && oaInfo.description.trim()) ||
+            (typeof biz.desc === "string" && biz.desc.trim()) ||
+            (typeof prof.status === "string" && prof.status.trim()) ||
+            "",
+        category: pickFieldValue(oaInfo?.category, fallbackCategory),
+        address: pickFieldValue(oaInfo?.address, biz.addr),
+        website: pickFieldValue(oaInfo?.website, biz.website),
+        hotline: pickFieldValue(oaInfo?.hotline, prof.phoneNumber),
+        openTime: pickFieldValue(oaInfo?.openTime),
+        email: typeof biz.email === "string" ? biz.email.trim() : "",
+        appUrl: typeof oaInfo?.appUrl === "string" ? oaInfo.appUrl : null,
+        dnrStatus,
+        oaInfo,
+        rawProfile: prof,
+        bizAccount: bizAccount ?? null,
+    };
+}
+/**
+ * Bóc tách và giải mã các loại tin nhắn từ Zalo Official Account (OA):
+ * - Danh sách bài viết / thẻ hành động OA (`chat.list.action`, bao gồm `l.a.header.full`, `l.a.normal`)
+ * - Thông báo sự kiện OA (`webchat` với `action === "msginfo.actionlist"` hoặc `"msginfo.action"`)
+ * - Thiệp chúc mừng / sự kiện OA (`chat.ecard`)
+ * - Tin nhắn hội thoại trực tiếp 2 chiều với OA (`pageMsgs`, có `footerv2`, hoặc `topOut === "1"`)
+ *
+ * Trả về `undefined` nếu tin nhắn là tin nhắn cá nhân thông thường không thuộc Zalo OA.
+ */
+function parseOAMessage(msg, options) {
+    if (!msg || typeof msg.msgType !== "string")
+        return undefined;
+    const msgType = msg.msgType.trim();
+    const rawContent = msg.content;
+    const contentObj = typeof rawContent === "object" && rawContent !== null
+        ? rawContent
+        : safeJsonParse(rawContent);
+    const footer = parseOAFooter(msg.footerv2 ?? msg.footer);
+    const topOut = msg.topOut === "1" || msg.topOut === 1 ? true : undefined;
+    // 1. Danh sách bài viết / Thẻ hành động OA (`chat.list.action`)
+    if (msgType === "chat.list.action") {
+        let items = [];
+        if (Array.isArray(rawContent)) {
+            items = rawContent;
+        }
+        else if (Array.isArray(contentObj)) {
+            items = contentObj;
+        }
+        else if (contentObj && typeof contentObj === "object") {
+            if (Array.isArray(contentObj.items)) {
+                items = contentObj.items;
+            }
+            else if (Array.isArray(contentObj.elements)) {
+                items = contentObj.elements;
+            }
+            else {
+                const parsedParams = safeJsonParse(contentObj.params);
+                if (Array.isArray(parsedParams)) {
+                    items = parsedParams;
+                }
+                else {
+                    items = [contentObj];
+                }
+            }
+        }
+        const itemLines = items
+            .map((it) => {
+            const t = typeof it.title === "string" ? it.title.trim() : "";
+            const d = typeof it.description === "string" ? it.description.trim() : "";
+            if (t && d)
+                return `${t}: ${d}`;
+            return t || d;
+        })
+            .filter(Boolean);
+        return {
+            kind: "oa_list",
+            text: itemLines.join("\n"),
+            bundleData: contentObj ?? {},
+            items,
+            footer,
+            topOut,
+            canReply: true,
+        };
+    }
+    // 2. Tin nhắn thông báo / ActionList OA (`webchat` với `action === "msginfo.actionlist"` hoặc `"msginfo.action"`)
+    if ((msgType === "webchat" || msgType === "msginfo.actionlist" || msgType === "msginfo.action") &&
+        contentObj &&
+        (contentObj.action === "msginfo.actionlist" ||
+            contentObj.action === "msginfo.action" ||
+            msgType.startsWith("msginfo."))) {
+        const paramsObj = safeJsonParse(contentObj.params) ?? contentObj;
+        const highLights = paramsObj.highLightsV2;
+        const textVi = paramsObj.msg?.vi ? formatOAHighlightText(paramsObj.msg.vi, highLights) : undefined;
+        const textEn = paramsObj.msg?.en ? formatOAHighlightText(paramsObj.msg.en, highLights) : undefined;
+        const previewTxt = typeof paramsObj.previewTxt === "string"
+            ? formatOAHighlightText(paramsObj.previewTxt, highLights)
+            : undefined;
+        const fallbackTitle = typeof contentObj.title === "string" ? contentObj.title : "";
+        const fallbackDesc = typeof contentObj.description === "string" ? contentObj.description : "";
+        return {
+            kind: "info_chat",
+            text: textVi || textEn || previewTxt || [fallbackTitle, fallbackDesc].filter(Boolean).join(" — "),
+            textVi,
+            textEn,
+            bundleData: paramsObj,
+            footer,
+            topOut,
+            metadata: { customMsg: paramsObj },
+        };
+    }
+    // 3. Thiệp chúc mừng / ECard OA (`chat.ecard`)
+    if (msgType === "chat.ecard") {
+        const paramsObj = safeJsonParse(contentObj?.params) ?? {};
+        const highLights = paramsObj.highLightsV2;
+        const textVi = paramsObj.msg?.vi ? formatOAHighlightText(paramsObj.msg.vi, highLights) : undefined;
+        const textEn = paramsObj.msg?.en ? formatOAHighlightText(paramsObj.msg.en, highLights) : undefined;
+        const previewTxt = typeof paramsObj.previewTxt === "string"
+            ? formatOAHighlightText(paramsObj.previewTxt, highLights)
+            : undefined;
+        const fallbackTitle = typeof contentObj?.title === "string" ? contentObj.title.trim() : "";
+        const fallbackDesc = typeof contentObj?.description === "string" ? contentObj.description.trim() : "";
+        return {
+            kind: "ecard",
+            text: textVi || textEn || previewTxt || [fallbackTitle, fallbackDesc].filter(Boolean).join(" — "),
+            textVi,
+            textEn,
+            bundleData: (contentObj ?? paramsObj),
+            footer,
+            topOut,
+            metadata: { customMsg: paramsObj },
+        };
+    }
+    // 4. Tin nhắn hội thoại trực tiếp 2 chiều với Zalo Official Account (`pageMsgs` / `footerv2` / `topOut === "1"`)
+    const hasOAMarkers = Boolean(options?.isPageMsg) || footer !== undefined || Boolean(topOut);
+    if (hasOAMarkers) {
+        let text = "";
+        if (typeof rawContent === "string") {
+            text = rawContent;
+        }
+        else if (contentObj && typeof contentObj === "object") {
+            const title = typeof contentObj.title === "string" ? contentObj.title.trim() : "";
+            const desc = typeof contentObj.description === "string" ? contentObj.description.trim() : "";
+            const href = typeof contentObj.href === "string" ? contentObj.href.trim() : "";
+            text = [title, desc].filter(Boolean).join(" — ") || href || JSON.stringify(contentObj);
+        }
+        return {
+            kind: "oa_chat",
+            text,
+            bundleData: contentObj ?? {},
+            footer,
+            topOut,
+            canReply: true,
+        };
+    }
+    return undefined;
+}
+function initializeOAEvent(data, act) {
+    const uids = Array.isArray(data?.uids) ? data.uids.map(String) : [];
+    return {
+        act,
+        act_type: "oa",
+        data: {
+            ...data,
+            uids,
+        },
+        isBlocked: act === "block",
+        oaIds: uids,
+    };
+}
+
+exports.formatOAHighlightText = formatOAHighlightText;
+exports.initializeOAEvent = initializeOAEvent;
+exports.isOAProfile = isOAProfile;
+exports.isOAVerified = isOAVerified;
+exports.isZaloBot = isZaloBot;
+exports.normalizeOAProfile = normalizeOAProfile;
+exports.parseOADnrStatus = parseOADnrStatus;
+exports.parseOAFooter = parseOAFooter;
+exports.parseOAMessage = parseOAMessage;

package/dist/cjs/realtime/handlers/control.handler.cjs

@@ -3,12 +3,13 @@
 var CallEvent = require('../../models/CallEvent.cjs');
 var FriendEvent = require('../../models/FriendEvent.cjs');
 var GroupEvent = require('../../models/GroupEvent.cjs');
+var OAMessage = require('../../models/OAMessage.cjs');
 var SyncEvent = require('../../models/SyncEvent.cjs');
 var utils = require('../../utils.cjs');
 var wsCipher = require('../../crypto/ws-cipher.cjs');
 
 async function handleRealtimeControlPacket(listener, ctx, selfListen, version, cmd, subCmd, parsed, cipherKey) {
-    if (version == 1 && (cmd == 601 || cmd == 603 || cmd == 604) && subCmd == 0) {
+    if (version == 1 && (cmd == 601 || cmd == 602 || cmd == 603 || cmd == 604) && (subCmd == 0 || subCmd == 1)) {
         const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
         const parsedData = decoded?.data;
         const controls = parsedData?.controls;
@@ -89,6 +90,13 @@ async function handleRealtimeControlPacket(listener, ctx, selfListen, version, c
                     data: v2tData,
                 });
             }
+            else if (control.content.act_type == "oa") {
+                const oaData = typeof control.content.data == "string"
+                    ? JSON.parse(control.content.data)
+                    : control.content.data;
+                const oaEvent = OAMessage.initializeOAEvent(oaData, control.content.act);
+                listener.emit("oa_event", oaEvent);
+            }
         }
         return true;
     }

package/dist/cjs/realtime/handlers/message.handler.cjs

@@ -17,64 +17,130 @@ require('../../models/CallEvent.cjs');
 var utils = require('../../utils.cjs');
 var wsCipher = require('../../crypto/ws-cipher.cjs');
 
-async function handleRealtimeMessagePacket(listener, ctx, selfListen, onMessageCallback, version, cmd, subCmd, parsed, cipherKey) {
-    if (version == 1 && [501, 551].includes(cmd) && subCmd == 0) {
-        const parsedData = (await wsCipher.decodeEventData(parsed, cipherKey)).data;
-        const { msgs } = parsedData;
-        for (const msg of msgs) {
-            if (typeof msg.content == "object" && utils.hasOwn(msg.content, "deleteMsg")) {
-                const undoObject = new Undo.Undo(ctx.uid, msg, false);
-                if (undoObject.isSelf && !selfListen)
-                    continue;
-                listener.emit("undo", undoObject);
-            }
-            else {
-                const messageObject = new Message.UserMessage(ctx.uid, msg);
-                if (messageObject.isSelf && !selfListen)
-                    continue;
-                onMessageCallback(messageObject);
-                listener.emit("message", messageObject);
+function processIncomingUserMessages(listener, ctx, selfListen, onMessageCallback, messages, isPageMsg = false) {
+    for (const msg of messages) {
+        if (!msg)
+            continue;
+        if (typeof msg.content == "object" && msg.content !== null && utils.hasOwn(msg.content, "deleteMsg")) {
+            const undoObject = new Undo.Undo(ctx.uid, msg, false);
+            if (undoObject.isSelf && !selfListen)
+                continue;
+            listener.emit("undo", undoObject);
+        }
+        else {
+            const messageObject = new Message.UserMessage(ctx.uid, msg, isPageMsg);
+            if (messageObject.isSelf && !selfListen)
+                continue;
+            onMessageCallback(messageObject);
+            listener.emit("message", messageObject);
+            if (messageObject.isOAMessage()) {
+                listener.emit("oa_message", messageObject);
             }
         }
+    }
+}
+function processIncomingGroupMessages(listener, ctx, selfListen, onMessageCallback, groupMessages) {
+    for (const msg of groupMessages) {
+        if (!msg)
+            continue;
+        if (typeof msg.content == "object" && msg.content !== null && utils.hasOwn(msg.content, "deleteMsg")) {
+            const undoObject = new Undo.Undo(ctx.uid, msg, true);
+            if (undoObject.isSelf && !selfListen)
+                continue;
+            listener.emit("undo", undoObject);
+        }
+        else {
+            const messageObject = new Message.GroupMessage(ctx.uid, msg);
+            if (messageObject.isSelf && !selfListen)
+                continue;
+            onMessageCallback(messageObject);
+            listener.emit("message", messageObject);
+        }
+    }
+}
+async function handleRealtimeMessagePacket(listener, ctx, selfListen, onMessageCallback, version, cmd, subCmd, parsed, cipherKey) {
+    if (version == 1 && [501, 551].includes(cmd) && subCmd == 0) {
+        const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
+        const parsedData = decoded?.data ?? decoded;
+        const msgs = (Array.isArray(parsedData?.msgs) ? parsedData.msgs : []);
+        const pageMsgs = (Array.isArray(parsedData?.pageMsgs) ? parsedData.pageMsgs : []);
+        if (msgs.length > 0)
+            processIncomingUserMessages(listener, ctx, selfListen, onMessageCallback, msgs, false);
+        if (pageMsgs.length > 0)
+            processIncomingUserMessages(listener, ctx, selfListen, onMessageCallback, pageMsgs, true);
         return true;
     }
     if (version == 1 && cmd == 521 && subCmd == 0) {
-        const parsedData = (await wsCipher.decodeEventData(parsed, cipherKey)).data;
-        const { groupMsgs } = parsedData;
-        for (const msg of groupMsgs) {
-            if (typeof msg.content == "object" && utils.hasOwn(msg.content, "deleteMsg")) {
-                const undoObject = new Undo.Undo(ctx.uid, msg, true);
-                if (undoObject.isSelf && !selfListen)
-                    continue;
-                listener.emit("undo", undoObject);
-            }
-            else {
-                const messageObject = new Message.GroupMessage(ctx.uid, msg);
-                if (messageObject.isSelf && !selfListen)
-                    continue;
-                onMessageCallback(messageObject);
-                listener.emit("message", messageObject);
-            }
+        const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
+        const parsedData = decoded?.data ?? decoded;
+        const groupMsgs = (Array.isArray(parsedData?.groupMsgs) ? parsedData.groupMsgs : []);
+        processIncomingGroupMessages(listener, ctx, selfListen, onMessageCallback, groupMsgs);
+        return true;
+    }
+    // HAS_MSG (cmd = 533): Server báo có tin nhắn đang chờ (thường gặp với OA / Missed Queue) -> kéo ngay qua cmd = 570 (GET_MSG)
+    if (cmd == 533 && subCmd == 0) {
+        const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
+        const parsedData = (decoded?.data ?? decoded);
+        if (parsedData?.queueId && Array.isArray(parsedData.ids) && parsedData.ids.length > 0) {
+            listener.requestMessagesByIds(parsedData.queueId, parsedData.ids);
+        }
+        return true;
+    }
+    // PUSH_MISS_MSG (cmd = 534) & GET_MSG (cmd = 570): Gói tin trả về các tin nhắn OA (`pageMsgs`), User (`msgs`) và Group (`groupMsgs`)
+    if ((cmd == 534 || cmd == 570) && subCmd == 0) {
+        const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
+        const parsedData = decoded?.data ?? decoded;
+        const msgs = (Array.isArray(parsedData?.msgs) ? parsedData.msgs : []);
+        const pageMsgs = (Array.isArray(parsedData?.pageMsgs) ? parsedData.pageMsgs : []);
+        const groupMsgs = (Array.isArray(parsedData?.groupMsgs) ? parsedData.groupMsgs : []);
+        if (msgs.length > 0) {
+            processIncomingUserMessages(listener, ctx, selfListen, onMessageCallback, msgs, false);
+        }
+        if (pageMsgs.length > 0) {
+            processIncomingUserMessages(listener, ctx, selfListen, onMessageCallback, pageMsgs, true);
+        }
+        if (groupMsgs.length > 0) {
+            processIncomingGroupMessages(listener, ctx, selfListen, onMessageCallback, groupMsgs);
         }
         return true;
     }
     if (cmd == 510 && (subCmd == 0 || subCmd == 1)) {
         const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
         const parsedData = decoded?.data ?? decoded;
-        const msgs = (parsedData?.msgs ?? []);
+        const msgs = (Array.isArray(parsedData?.msgs) ? parsedData.msgs : []);
+        const pageMsgs = (Array.isArray(parsedData?.pageMsgs) ? parsedData.pageMsgs : []);
         const responseMsgs = [];
         for (const msg of msgs) {
-            if (typeof msg.content == "object" && utils.hasOwn(msg.content, "deleteMsg")) {
+            if (typeof msg.content == "object" && msg.content !== null && utils.hasOwn(msg.content, "deleteMsg")) {
+                const undoObject = new Undo.Undo(ctx.uid, msg, false);
+                if (undoObject.isSelf && !selfListen)
+                    continue;
+                listener.emit("undo", undoObject);
+            }
+            else {
+                const userMsg = new Message.UserMessage(ctx.uid, msg, false);
+                responseMsgs.push(userMsg);
+                if (userMsg.isOAMessage() && (!userMsg.isSelf || selfListen)) {
+                    listener.emit("oa_message", userMsg);
+                }
+            }
+        }
+        for (const msg of pageMsgs) {
+            if (typeof msg.content == "object" && msg.content !== null && utils.hasOwn(msg.content, "deleteMsg")) {
                 const undoObject = new Undo.Undo(ctx.uid, msg, false);
                 if (undoObject.isSelf && !selfListen)
                     continue;
                 listener.emit("undo", undoObject);
             }
             else {
-                responseMsgs.push(new Message.UserMessage(ctx.uid, msg));
+                const oaUserMsg = new Message.UserMessage(ctx.uid, msg, true);
+                responseMsgs.push(oaUserMsg);
+                if (oaUserMsg.isOAMessage() && (!oaUserMsg.isSelf || selfListen)) {
+                    listener.emit("oa_message", oaUserMsg);
+                }
             }
         }
-        if (responseMsgs.length > 0 || msgs.length === 0) {
+        if (responseMsgs.length > 0 || (msgs.length === 0 && pageMsgs.length === 0)) {
             listener.emit("old_messages", responseMsgs, Enum.ThreadType.User, parsedData?.more === 1);
         }
         return true;

package/dist/cjs/realtime/listener.cjs

@@ -330,18 +330,19 @@ class Listener extends EventEmitter {
     }
     sendWs(payload, requireId = true) {
         if (this.ws && (this.ws.readyState === undefined || this.ws.readyState === WebSocket.OPEN)) {
-            if (requireId)
-                payload.data["req_id"] = `req_${this.id++}`;
+            if (requireId) {
+                const reqId = `req_${this.id++}`;
+                payload.data["req_id"] = reqId;
+                payload.data["reqId"] = reqId;
+            }
             const encodedData = new TextEncoder().encode(JSON.stringify(payload.data));
             const dataLength = encodedData.length;
-            const data = new DataView(Buffer.alloc(4 + dataLength).buffer);
-            data.setUint8(0, payload.version);
-            data.setInt32(1, payload.cmd, true);
-            data.setInt8(3, payload.subCmd);
-            encodedData.forEach((e, i) => {
-                data.setUint8(4 + i, e);
-            });
-            this.ws.send(data);
+            const buf = Buffer.alloc(4 + dataLength);
+            buf.writeUInt8(payload.version, 0);
+            buf.writeUInt16LE(payload.cmd, 1);
+            buf.writeInt8(payload.subCmd, 3);
+            Buffer.from(encodedData).copy(buf, 4);
+            this.ws.send(buf);
         }
     }
     /**
@@ -376,16 +377,36 @@ class Listener extends EventEmitter {
         this.sendWs(payload);
     }
     /**
-     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL và `cmd 604` CTRL_PULL_VOIP).
-     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông ngay cả khi vừa mở kết nối WebSocket.
+     * Kéo danh sách tin nhắn cụ thể theo `queueId` và mảng `ids` (`cmd 570` GET_MSG)
+     * khi nhận tín hiệu `cmd 533` (`HAS_MSG`) từ Zalo WebSocket (thường dùng cho tin nhắn OA / ZNS / Missed Queue).
+     * Tự động chia batch tối đa 20 ID mỗi gói theo đúng cấu hình `max_msg_get = 20` trên Zalo Desktop.
+     */
+    requestMessagesByIds(queueId, ids, lastId = "0") {
+        if (!queueId || !Array.isArray(ids) || ids.length === 0)
+            return;
+        const maxBatchSize = 20;
+        for (let i = 0; i < ids.length; i += maxBatchSize) {
+            const chunk = ids.slice(i, i + maxBatchSize);
+            const reqId = `req_${this.id++}`;
+            this.sendWs({
+                version: 1,
+                cmd: 570,
+                subCmd: 0,
+                data: {
+                    queueId,
+                    ids: chunk,
+                    lastId,
+                    reqId,
+                    req_id: reqId,
+                },
+            }, false);
+        }
+    }
+    /**
+     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL).
+     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông và sự kiện điều khiển ngay cả khi vừa mở kết nối WebSocket.
      */
     requestOfflineVoipControls() {
-        this.sendWs({
-            version: 1,
-            cmd: 604,
-            subCmd: 0,
-            data: { first: true, lastId: 1, preIds: [] },
-        });
         this.sendWs({
             version: 1,
             cmd: 603,