@softtynet/zca-js 2.3.6 → 2.3.7

package/dist/models/OAMessage.js

@@ -0,0 +1,363 @@
+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.
+ */
+export 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`).
+ */
+export 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`.
+ */
+export 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.
+ */
+export 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"`.
+ */
+export 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`).
+ */
+export 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.
+ */
+export 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.
+ */
+export 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;
+}
+export 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,
+    };
+}

package/dist/models/index.d.ts

@@ -24,3 +24,4 @@ export * from "./ClearUnread.js";
 export * from "./SyncEvent.js";
 export * from "./SyncData.js";
 export * from "./CallEvent.js";
+export * from "./OAMessage.js";

package/dist/models/index.js

@@ -24,3 +24,4 @@ export * from "./ClearUnread.js";
 export * from "./SyncEvent.js";
 export * from "./SyncData.js";
 export * from "./CallEvent.js";
+export * from "./OAMessage.js";

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

@@ -1,10 +1,11 @@
 import { initializeCallEvent } from "../../models/CallEvent.js";
 import { initializeFriendEvent } from "../../models/FriendEvent.js";
 import { initializeGroupEvent } from "../../models/GroupEvent.js";
+import { initializeOAEvent } from "../../models/OAMessage.js";
 import { initializeSyncEvent } from "../../models/SyncEvent.js";
 import { decodeEventData, getFriendEventType, getGroupEventType } from "../../utils.js";
 export 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 decodeEventData(parsed, cipherKey);
         const parsedData = decoded?.data;
         const controls = parsedData?.controls;
@@ -85,6 +86,13 @@ export async function handleRealtimeControlPacket(listener, ctx, selfListen, ver
                     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 = initializeOAEvent(oaData, control.content.act);
+                listener.emit("oa_event", oaEvent);
+            }
         }
         return true;
     }

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

@@ -1,63 +1,129 @@
 import { GroupMessage, ThreadType, Undo, UserMessage } from "../../models/index.js";
 import { decodeEventData, hasOwn } from "../../utils.js";
-export async function handleRealtimeMessagePacket(listener, ctx, selfListen, onMessageCallback, version, cmd, subCmd, parsed, cipherKey) {
-    if (version == 1 && [501, 551].includes(cmd) && subCmd == 0) {
-        const parsedData = (await decodeEventData(parsed, cipherKey)).data;
-        const { msgs } = parsedData;
-        for (const msg of msgs) {
-            if (typeof msg.content == "object" && hasOwn(msg.content, "deleteMsg")) {
-                const undoObject = new Undo(ctx.uid, msg, false);
-                if (undoObject.isSelf && !selfListen)
-                    continue;
-                listener.emit("undo", undoObject);
-            }
-            else {
-                const messageObject = new 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 && hasOwn(msg.content, "deleteMsg")) {
+            const undoObject = new Undo(ctx.uid, msg, false);
+            if (undoObject.isSelf && !selfListen)
+                continue;
+            listener.emit("undo", undoObject);
+        }
+        else {
+            const messageObject = new 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 && hasOwn(msg.content, "deleteMsg")) {
+            const undoObject = new Undo(ctx.uid, msg, true);
+            if (undoObject.isSelf && !selfListen)
+                continue;
+            listener.emit("undo", undoObject);
+        }
+        else {
+            const messageObject = new GroupMessage(ctx.uid, msg);
+            if (messageObject.isSelf && !selfListen)
+                continue;
+            onMessageCallback(messageObject);
+            listener.emit("message", messageObject);
+        }
+    }
+}
+export async function handleRealtimeMessagePacket(listener, ctx, selfListen, onMessageCallback, version, cmd, subCmd, parsed, cipherKey) {
+    if (version == 1 && [501, 551].includes(cmd) && subCmd == 0) {
+        const decoded = await 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 decodeEventData(parsed, cipherKey)).data;
-        const { groupMsgs } = parsedData;
-        for (const msg of groupMsgs) {
-            if (typeof msg.content == "object" && hasOwn(msg.content, "deleteMsg")) {
-                const undoObject = new Undo(ctx.uid, msg, true);
-                if (undoObject.isSelf && !selfListen)
-                    continue;
-                listener.emit("undo", undoObject);
-            }
-            else {
-                const messageObject = new GroupMessage(ctx.uid, msg);
-                if (messageObject.isSelf && !selfListen)
-                    continue;
-                onMessageCallback(messageObject);
-                listener.emit("message", messageObject);
-            }
+        const decoded = await 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 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 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 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" && hasOwn(msg.content, "deleteMsg")) {
+            if (typeof msg.content == "object" && msg.content !== null && hasOwn(msg.content, "deleteMsg")) {
+                const undoObject = new Undo(ctx.uid, msg, false);
+                if (undoObject.isSelf && !selfListen)
+                    continue;
+                listener.emit("undo", undoObject);
+            }
+            else {
+                const userMsg = new 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 && hasOwn(msg.content, "deleteMsg")) {
                 const undoObject = new Undo(ctx.uid, msg, false);
                 if (undoObject.isSelf && !selfListen)
                     continue;
                 listener.emit("undo", undoObject);
             }
             else {
-                responseMsgs.push(new UserMessage(ctx.uid, msg));
+                const oaUserMsg = new 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, ThreadType.User, parsedData?.more === 1);
         }
         return true;

package/dist/realtime/listener.d.ts

@@ -1,7 +1,7 @@
 import EventEmitter from "events";
 import { ThreadType } from "../models/index.js";
 import type { ContextSession } from "../context.js";
-import { type ListenerEvents, type OnClosedCallback, type OnErrorCallback, type OnMessageCallback, type WsPayload } from "./types.js";
+import { type HasMsgIdItem, type HasMsgQueueId, type ListenerEvents, type OnClosedCallback, type OnErrorCallback, type OnMessageCallback, type WsPayload } from "./types.js";
 export declare class Listener extends EventEmitter<ListenerEvents> {
     private ctx;
     private urls;
@@ -67,8 +67,14 @@ export declare class Listener extends EventEmitter<ListenerEvents> {
      */
     requestOldReactions(threadType: ThreadType, lastMsgId?: string | null): void;
     /**
-     * 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: HasMsgQueueId, ids: HasMsgIdItem[], lastId?: string): void;
+    /**
+     * 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(): void;
     private reset;