@softtynet/zca-js 2.3.6 → 2.3.7

package/dist/cjs/apis/chat/preloadConversations.cjs

@@ -43,6 +43,7 @@ const preloadConversationsFactory = utils.apiFactory()((api, ctx, utils) => {
                 data = JSON.parse(data);
             }
             const messages = [];
+            const pageMessages = [];
             const seenMsgIds = new Set();
             if (Array.isArray(data.msgs)) {
                 for (const msg of data.msgs) {
@@ -54,6 +55,18 @@ const preloadConversationsFactory = utils.apiFactory()((api, ctx, utils) => {
                     messages.push(new Message.UserMessage(ctx.uid, msg));
                 }
             }
+            if (Array.isArray(data.pageMsgs)) {
+                for (const msg of data.pageMsgs) {
+                    const id = String(msg.msgId ?? "");
+                    if (id && seenMsgIds.has(id))
+                        continue;
+                    if (id)
+                        seenMsgIds.add(id);
+                    const userMsg = new Message.UserMessage(ctx.uid, msg, true);
+                    pageMessages.push(userMsg);
+                    messages.push(userMsg);
+                }
+            }
             if (Array.isArray(data.groupMsgs)) {
                 for (const msg of data.groupMsgs) {
                     const id = String(msg.msgId ?? "");
@@ -87,6 +100,7 @@ const preloadConversationsFactory = utils.apiFactory()((api, ctx, utils) => {
             return {
                 ...data,
                 messages,
+                pageMessages,
                 unreadCleared,
             };
         });

package/dist/cjs/apis/sync/getSyncData.cjs

@@ -7,10 +7,29 @@ var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
 var utils = require('../../utils.cjs');
 var domains = require('../../constants/domains.cjs');
 
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var toughCookie__namespace = /*#__PURE__*/_interopNamespaceDefault(toughCookie);
+
 const getSyncDataFactory = utils.apiFactory()((api, ctx, utils) => {
     async function downloadFileStream(url) {
         if (!ctx.cookie)
-            ctx.cookie = new toughCookie.CookieJar();
+            ctx.cookie = new toughCookie__namespace.CookieJar();
         const cookie = ctx.cookie;
         const manualHeaders = {
             "Cache-Control": "no-store, must-revalidate",

package/dist/cjs/apis.cjs

@@ -15,6 +15,7 @@ var analyseGroup = require('./apis/group/analyseGroup.cjs');
 var answerAckVoiceCall = require('./apis/call/answerAckVoiceCall.cjs');
 var answerGroupCall = require('./apis/call/answerGroupCall.cjs');
 var answerVoiceCall = require('./apis/call/answerVoiceCall.cjs');
+var blockOA = require('./apis/business/blockOA.cjs');
 var blockUser = require('./apis/friend/blockUser.cjs');
 var blockViewFeed = require('./apis/friend/blockViewFeed.cjs');
 var broadcastGroupCallState = require('./apis/call/broadcastGroupCallState.cjs');
@@ -28,6 +29,7 @@ var changeGroupName = require('./apis/group/changeGroupName.cjs');
 var changeGroupOwner = require('./apis/group/changeGroupOwner.cjs');
 var checkQuotaCommunityMember = require('./apis/group/checkQuotaCommunityMember.cjs');
 var clearUnreadFriendRequests = require('./apis/friend/clearUnreadFriendRequests.cjs');
+var convertOAIds = require('./apis/business/convertOAIds.cjs');
 var createAutoReply = require('./apis/business/createAutoReply.cjs');
 var createBankAccount = require('./apis/business/createBankAccount.cjs');
 var createCatalog = require('./apis/business/createCatalog.cjs');
@@ -129,6 +131,7 @@ var getMultiGroupCloudMessages = require('./apis/group/getMultiGroupCloudMessage
 var getMultiUsersByPhones = require('./apis/friend/getMultiUsersByPhones.cjs');
 var getMute = require('./apis/chat/getMute.cjs');
 var getNoisedIds = require('./apis/auth/getNoisedIds.cjs');
+var getOAProfile = require('./apis/business/getOAProfile.cjs');
 var getOwnId = require('./apis/auth/getOwnId.cjs');
 var getPendingGroupMembers = require('./apis/group/getPendingGroupMembers.cjs');
 var getPersonalizedStickerList = require('./apis/sticker/getPersonalizedStickerList.cjs');
@@ -224,6 +227,7 @@ var setMute = require('./apis/chat/setMute.cjs');
 var setPinnedConversations = require('./apis/chat/setPinnedConversations.cjs');
 var sharePoll = require('./apis/board/sharePoll.cjs');
 var shareScreenGroupCall = require('./apis/call/shareScreenGroupCall.cjs');
+var unblockOA = require('./apis/business/unblockOA.cjs');
 var unblockUser = require('./apis/friend/unblockUser.cjs');
 var undo = require('./apis/chat/undo.cjs');
 var undoFriendRequest = require('./apis/friend/undoFriendRequest.cjs');
@@ -322,6 +326,8 @@ class API {
         if (!this._domains.business) {
             const createNamespace = (api) => ({
                 get addQuickMessage() { return api.addQuickMessage; },
+                get blockOA() { return api.blockOA; },
+                get convertOAIds() { return api.convertOAIds; },
                 get createAutoReply() { return api.createAutoReply; },
                 get createBankAccount() { return api.createBankAccount; },
                 get createCatalog() { return api.createCatalog; },
@@ -336,10 +342,12 @@ class API {
                 get getLabels() { return api.getLabels; },
                 get getListBank() { return api.getListBank; },
                 get getListBankAccount() { return api.getListBankAccount; },
+                get getOAProfile() { return api.getOAProfile; },
                 get getProductCatalogList() { return api.getProductCatalogList; },
                 get getQuickMessageList() { return api.getQuickMessageList; },
                 get registerCatalog() { return api.registerCatalog; },
                 get removeQuickMessage() { return api.removeQuickMessage; },
+                get unblockOA() { return api.unblockOA; },
                 get updateAutoReply() { return api.updateAutoReply; },
                 get updateBankAccount() { return api.updateBankAccount; },
                 get updateCatalog() { return api.updateCatalog; },
@@ -662,6 +670,9 @@ class API {
     get answerVoiceCall() {
         return (this._cache.answerVoiceCall ??= answerVoiceCall.answerVoiceCallFactory(this.ctx, this));
     }
+    get blockOA() {
+        return (this._cache.blockOA ??= blockOA.blockOAFactory(this.ctx, this));
+    }
     get blockUser() {
         return (this._cache.blockUser ??= blockUser.blockUserFactory(this.ctx, this));
     }
@@ -701,6 +712,9 @@ class API {
     get clearUnreadFriendRequests() {
         return (this._cache.clearUnreadFriendRequests ??= clearUnreadFriendRequests.clearUnreadFriendRequestsFactory(this.ctx, this));
     }
+    get convertOAIds() {
+        return (this._cache.convertOAIds ??= convertOAIds.convertOAIdsFactory(this.ctx, this));
+    }
     get createAutoReply() {
         return (this._cache.createAutoReply ??= createAutoReply.createAutoReplyFactory(this.ctx, this));
     }
@@ -1004,6 +1018,9 @@ class API {
     get getNoisedIds() {
         return (this._cache.getNoisedIds ??= getNoisedIds.getNoisedIdsFactory(this.ctx, this));
     }
+    get getOAProfile() {
+        return (this._cache.getOAProfile ??= getOAProfile.getOAProfileFactory(this.ctx, this));
+    }
     get getOwnId() {
         return (this._cache.getOwnId ??= getOwnId.getOwnIdFactory(this.ctx, this));
     }
@@ -1289,6 +1306,9 @@ class API {
     get shareScreenGroupCall() {
         return (this._cache.shareScreenGroupCall ??= shareScreenGroupCall.shareScreenGroupCallFactory(this.ctx, this));
     }
+    get unblockOA() {
+        return (this._cache.unblockOA ??= unblockOA.unblockOAFactory(this.ctx, this));
+    }
     get unblockUser() {
         return (this._cache.unblockUser ??= unblockUser.unblockUserFactory(this.ctx, this));
     }

package/dist/cjs/constants/defaults.cjs

@@ -37,8 +37,8 @@ const ZALO_DEFAULTS = {
         /** Số lần lỗi 1006 liên tiếp trước khi xoay sang WebSocket endpoint tiếp theo */
         CONSECUTIVE_1006_ROTATE_THRESHOLD: 2,
         /** Con trỏ mặc định khi bắt đầu kéo hàng đợi tin nhắn cũ (cmd 510 / 511) */
-        OLD_MSG_INITIAL_CURSOR: "10000000000000000",
-        INITIAL_OLD_MESSAGES_CURSOR: "10000000000000000",
+        OLD_MSG_INITIAL_CURSOR: "1",
+        INITIAL_OLD_MESSAGES_CURSOR: "1",
     },
     UPLOAD: {
         /** Thời gian sống tối đa của uploadCallback trong bộ nhớ trước khi tự hủy (5 phút) */

package/dist/cjs/constants/protocol.cjs

@@ -12,7 +12,7 @@ const ZALO_PROTOCOL = {
     API_VERSION: 689,
     DEFAULT_API_VERSION: 689,
     /** Phiên bản SDK hiện tại */
-    SDK_VERSION: "2.3.6",
+    SDK_VERSION: "2.3.7",
     /** Mã zpw_type đặc thù dành riêng cho phân hệ Gọi Thoại & Video (binary C++ ZaloCall) */
     VOICECALL_API_TYPE: 24,
     /** Phiên bản mã hóa ZCID (ParamDecryptor) */

package/dist/cjs/index.cjs

@@ -22,6 +22,7 @@ var ZBusiness = require('./models/ZBusiness.cjs');
 var ClearUnread = require('./models/ClearUnread.cjs');
 var SyncEvent = require('./models/SyncEvent.cjs');
 var CallEvent = require('./models/CallEvent.cjs');
+var OAMessage = require('./models/OAMessage.cjs');
 var protocol = require('./constants/protocol.cjs');
 var domains = require('./constants/domains.cjs');
 var defaults = require('./constants/defaults.cjs');
@@ -145,6 +146,15 @@ Object.defineProperty(exports, "CallEventType", {
 	get: function () { return CallEvent.CallEventType; }
 });
 exports.initializeCallEvent = CallEvent.initializeCallEvent;
+exports.formatOAHighlightText = OAMessage.formatOAHighlightText;
+exports.initializeOAEvent = OAMessage.initializeOAEvent;
+exports.isOAProfile = OAMessage.isOAProfile;
+exports.isOAVerified = OAMessage.isOAVerified;
+exports.isZaloBot = OAMessage.isZaloBot;
+exports.normalizeOAProfile = OAMessage.normalizeOAProfile;
+exports.parseOADnrStatus = OAMessage.parseOADnrStatus;
+exports.parseOAFooter = OAMessage.parseOAFooter;
+exports.parseOAMessage = OAMessage.parseOAMessage;
 exports.ZALO_PROTOCOL = protocol.ZALO_PROTOCOL;
 exports.ZALO_DOMAINS = domains.ZALO_DOMAINS;
 exports.ZALO_DEFAULTS = defaults.ZALO_DEFAULTS;

package/dist/cjs/models/Message.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var Enum = require('./Enum.cjs');
+var OAMessage = require('./OAMessage.cjs');
 
 class UserMessage {
     type = Enum.ThreadType.User;
@@ -10,7 +11,11 @@ class UserMessage {
      * true if the message is sent by the logged in account
      */
     isSelf;
-    constructor(uid, data) {
+    /**
+     * Dữ liệu đã giải mã nếu đây là tin nhắn từ Zalo Official Account (OA) (`pageMsgs`, `footerv2`, `chat.list.action`, `msginfo.actionlist`, hoặc `chat.ecard`).
+     */
+    oaData;
+    constructor(uid, data, isPageMsg = false) {
         this.data = data;
         this.threadId = data.uidFrom == "0" ? data.idTo : data.uidFrom;
         this.isSelf = data.uidFrom == "0";
@@ -21,6 +26,16 @@ class UserMessage {
         if (data.quote) {
             data.quote.ownerId = String(data.quote.ownerId);
         }
+        const parsedOA = OAMessage.parseOAMessage(data, { isPageMsg });
+        if (parsedOA) {
+            this.oaData = parsedOA;
+        }
+    }
+    /**
+     * Kiểm tra xem tin nhắn có phải là tin nhắn Zalo Official Account (OA) hay không.
+     */
+    isOAMessage() {
+        return this.oaData !== undefined;
     }
 }
 class GroupMessage {

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;
     }