@softtynet/zca-js 2.3.2 → 2.3.3

package/dist/cjs/apis/group/getGroupChatHistory.cjs

@@ -16,65 +16,87 @@ 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`);
+const getGroupChatHistoryFactory = utils.apiFactory()((api, ctx, utils$1) => {
+    const recentServiceURL = utils$1.makeURL(`${api.zpwServiceMap.group_cloud_message[0]}/api/cm/getrecentv2`);
+    const oldServiceURL = utils$1.makeURL(`${api.zpwServiceMap.group_cloud_message[0]}/api/cm/getoldv2`);
     /**
-     * Get group chat history from Zalo Cloud Message (newest first)
+     * Lấy lịch sử tin nhắn nhóm từ Zalo Cloud Message (hỗ trợ cả `/api/cm/getrecentv2` cmd 12506 và `/api/cm/getoldv2` cmd 12507)
      *
-     * @param groupId group id
-     * @param count count of messages to return (default: 50, max safe limit: 200)
+     * @param groupId ID nhóm
+     * @param countOrOptions Số lượng tin nhắn cần tải (mặc định: `50`) hoặc đối tượng cấu hình phân trang `GetGroupChatHistoryOptions`
      *
      * @throws {ZaloApiError}
      */
-    return async function getGroupChatHistory(groupId, count = 50) {
+    return async function getGroupChatHistory(groupId, countOrOptions = 50) {
         if (!groupId)
             throw new ZaloApiError.ZaloApiError("Missing groupId");
         if (groupId.startsWith("g"))
             groupId = groupId.slice(1);
-        const safeCount = Math.min(Math.max(count, 1), 200);
+        const options = typeof countOrOptions === "number" ? { count: countOrOptions } : countOrOptions || {};
+        const requestedCount = Math.max(options.count ?? 50, 1);
+        const maxPages = options.maxPages ?? Math.max(10, Math.ceil(requestedCount / 50) + 2);
+        const targetServiceURL = options.useOldEndpoint ? oldServiceURL : recentServiceURL;
+        const msgIds = options.msgIds ?? [];
+        const src = options.src ?? 3;
         const messages = [];
-        let cursor = 0;
+        const seenMsgIds = new Set();
+        let cursor = options.cursor ?? 0;
         let lastPage = null;
         let pageCount = 0;
-        while (messages.length < safeCount && pageCount < 10) {
+        while (messages.length < requestedCount && pageCount < maxPages) {
             pageCount++;
             const params = {
                 groupId,
                 globalMsgId: cursor,
-                count: Math.min(50, safeCount - messages.length),
-                msgIds: [],
+                count: Math.min(50, requestedCount - messages.length),
+                msgIds,
                 imei: ctx.imei,
-                src: 3,
+                src,
             };
-            const encryptedParams = utils.encodeAES(JSON.stringify(params));
+            if (options.isOA) {
+                params.isOA = 1;
+            }
+            const encryptedParams = utils$1.encodeAES(JSON.stringify(params));
             if (!encryptedParams)
                 throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
-            const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams, nretry: 0 }), {
+            const response = await utils$1.request(utils$1.makeURL(targetServiceURL, { params: encryptedParams, nretry: 0 }), {
                 method: "GET",
             });
-            lastPage = await utils.resolve(response, (result) => {
+            lastPage = await utils$1.resolve(response, (result) => {
                 let data = result.data;
                 if (typeof data === "string") {
-                    data = JSON.parse(data);
+                    data = JSON.parse(utils.preParseJsonIds(data));
                 }
                 return data;
             });
             if (!lastPage || !Array.isArray(lastPage.groupMsgs))
                 break;
             for (const rawMsg of lastPage.groupMsgs) {
-                if (messages.length >= safeCount)
+                if (messages.length >= requestedCount)
                     break;
-                if (messages.some((m) => m.msgId === rawMsg.msgId))
+                const msgIdKey = String(rawMsg.msgId ?? rawMsg.cliMsgId ?? "");
+                if (msgIdKey && seenMsgIds.has(msgIdKey))
                     continue;
+                if (msgIdKey)
+                    seenMsgIds.add(msgIdKey);
                 messages.push(rawMsg);
             }
-            const nextCursor = Number(lastPage.lastMsgId);
-            if (!lastPage.hasMore || !nextCursor || nextCursor === cursor)
+            const nextCursor = lastPage.lastMsgId;
+            if (!lastPage.hasMore ||
+                nextCursor === undefined ||
+                nextCursor === null ||
+                nextCursor === "" ||
+                nextCursor === 0 ||
+                String(nextCursor) === String(cursor)) {
                 break;
+            }
             cursor = nextCursor;
         }
         const groupMsgs = messages.map((data) => new Message.GroupMessage(ctx.uid, data));
-        return Object.assign({}, lastPage || {}, { groupMsgs });
+        return Object.assign({}, lastPage || {}, {
+            groupMsgs,
+            nextCursor: lastPage?.lastMsgId,
+        });
     };
 });
 

package/dist/cjs/apis/group/getGroupHistoryLegacy.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+require('../../models/AutoReply.cjs');
+require('../../models/Bank.cjs');
+require('../../models/Board.cjs');
+require('../../models/Enum.cjs');
+require('../../models/FriendEvent.cjs');
+require('../../models/Group.cjs');
+require('../../models/GroupEvent.cjs');
+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');
+var utils = require('../../utils.cjs');
+
+const getGroupHistoryLegacyFactory = utils.apiFactory()((api, ctx, utils$1) => {
+    const serviceURL = utils$1.makeURL(`${api.zpwServiceMap.group[0]}/api/group/history`);
+    /**
+     * Lấy lịch sử tin nhắn nhóm qua endpoint `/api/group/history` trên miền `group` (command 11240)
+     *
+     * @param groupId ID của nhóm
+     * @param count Số lượng tin nhắn cần tải (mặc định: `20`)
+     * @throws {ZaloApiError}
+     */
+    return async function getGroupHistoryLegacy(groupId, count = 20) {
+        if (!groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        const cleanGroupId = groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const params = {
+            grid: cleanGroupId,
+            count,
+        };
+        const encryptedParams = utils$1.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils$1.request(utils$1.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils$1.resolve(response, (result) => {
+            let data = result.data;
+            if (typeof data === "string") {
+                try {
+                    data = JSON.parse(utils.preParseJsonIds(data));
+                }
+                catch {
+                    data = {};
+                }
+            }
+            if (Array.isArray(data)) {
+                const groupMsgs = data.map((m) => new Message.GroupMessage(ctx.uid, m));
+                return { groupMsgs };
+            }
+            if (data && typeof data === "object") {
+                const obj = data;
+                const rawList = Array.isArray(obj.groupMsgs)
+                    ? obj.groupMsgs
+                    : Array.isArray(obj.msgs)
+                        ? obj.msgs
+                        : null;
+                if (rawList) {
+                    const groupMsgs = rawList.map((m) => new Message.GroupMessage(ctx.uid, m));
+                    return {
+                        ...obj,
+                        groupMsgs,
+                    };
+                }
+                return obj;
+            }
+            return { groupMsgs: [] };
+        });
+    };
+});
+
+exports.getGroupHistoryLegacyFactory = getGroupHistoryLegacyFactory;

package/dist/cjs/apis/group/getGroupInfoV2.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const getGroupInfoV2Factory = utils.apiFactory()((api, ctx, utils) => {
+    const v2ServiceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/getgi/v2`);
+    const v1ServiceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/getgi`);
+    /**
+     * Lấy thông tin nhóm và danh sách thành viên theo trang qua `/api/group/getgi/v2` hoặc `/api/group/getgi` (command 11162)
+     *
+     * @param groupId ID của nhóm
+     * @param pageOrOptions Số trang `mpage` (mặc định: `1`) hoặc cấu hình `GetGroupInfoV2Options`
+     * @throws {ZaloApiError}
+     */
+    return async function getGroupInfoV2(groupId, pageOrOptions = 1) {
+        if (!groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        const cleanGroupId = groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const options = typeof pageOrOptions === "number" ? { mpage: pageOrOptions } : pageOrOptions || {};
+        const mpage = options.mpage ?? 1;
+        const mcount = options.mcount ?? 100;
+        const avatarSize = options.avatarSize ?? 120;
+        const memberAvatarSize = options.memberAvatarSize ?? 120;
+        const useV1 = Boolean(options.useV1Endpoint);
+        const targetURL = useV1 ? v1ServiceURL : v2ServiceURL;
+        const params = useV1
+            ? {
+                grid: cleanGroupId,
+                avatar_size: avatarSize,
+                member_avatar_size: memberAvatarSize,
+            }
+            : {
+                grid: cleanGroupId,
+                avatar_size: avatarSize,
+                member_avatar_size: memberAvatarSize,
+                mpage,
+                mcount,
+                imei: ctx.imei,
+            };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(targetURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getGroupInfoV2Factory = getGroupInfoV2Factory;

package/dist/cjs/apis/group/getGroupListV3.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const getGroupListV3Factory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/getlg/v3`);
+    /**
+     * Lấy danh sách nhóm theo trang kèm thông tin thành viên đại diện (`currentMems`) và gợi ý nhóm (`suggestGroup`) qua `/api/group/getlg/v3` (command 11161)
+     *
+     * @param pageOrOptions Số trang (mặc định: `1`) hoặc cấu hình `GetGroupListV3Options`
+     * @throws {ZaloApiError}
+     */
+    return async function getGroupListV3(pageOrOptions = 1) {
+        const options = typeof pageOrOptions === "number" ? { page: pageOrOptions } : pageOrOptions || {};
+        const params = {
+            page: options.page ?? 1,
+            count: options.count ?? 100,
+            avatar_size: 120,
+            member_avatar_size: 120,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getGroupListV3Factory = getGroupListV3Factory;

package/dist/cjs/apis/group/getGroupMessageStatus.cjs

@@ -0,0 +1,82 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const getGroupMessageStatusFactory = utils.apiFactory()((api, _ctx, utils$1) => {
+    const serviceURL = utils$1.makeURL(`${api.zpwServiceMap.group[0]}/api/group/getStatusMsg`);
+    /**
+     * Truy vấn trạng thái Đã nhận (`deliver`) và Đã xem (`seen`) tin nhắn của danh sách thành viên trong nhóm (command 12017)
+     *
+     * @param groupIdOrItems ID nhóm (hoặc mảng cấu hình `{ tId, ids }`)
+     * @param memberIds Danh sách UID thành viên cần kiểm tra (khi tham số đầu là `groupId`)
+     * @throws {ZaloApiError}
+     */
+    return async function getGroupMessageStatus(groupIdOrItems, memberIds = []) {
+        let queryData;
+        if (Array.isArray(groupIdOrItems)) {
+            queryData = groupIdOrItems.map((item) => ({
+                tId: item.tId.startsWith("g") ? item.tId.slice(1) : item.tId,
+                ids: item.ids.map(String),
+            }));
+        }
+        else {
+            if (!groupIdOrItems) {
+                throw new ZaloApiError.ZaloApiError("Missing groupId");
+            }
+            const cleanGroupId = groupIdOrItems.startsWith("g") ? groupIdOrItems.slice(1) : groupIdOrItems;
+            queryData = [
+                {
+                    tId: cleanGroupId,
+                    ids: memberIds.map(String),
+                },
+            ];
+        }
+        const params = {
+            param: JSON.stringify({
+                data: queryData,
+            }),
+        };
+        const encryptedParams = utils$1.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils$1.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils$1.resolve(response, (result) => {
+            let rawData = result.data;
+            if (typeof rawData === "string" && rawData.length > 0) {
+                try {
+                    const parsed = JSON.parse(utils.preParseJsonIds(rawData));
+                    if (parsed && typeof parsed === "object" && "data" in parsed && parsed.data) {
+                        rawData = parsed.data;
+                    }
+                    else {
+                        rawData = parsed;
+                    }
+                }
+                catch {
+                    // Giữ nguyên nếu không phải chuỗi JSON lồng
+                }
+            }
+            if (rawData && typeof rawData === "object") {
+                const obj = rawData;
+                if (Array.isArray(obj.statusInfos)) {
+                    return obj;
+                }
+                if (obj.data && typeof obj.data === "object" && Array.isArray(obj.data.statusInfos)) {
+                    return obj.data;
+                }
+            }
+            return {
+                statusInfos: Array.isArray(rawData) ? rawData : [],
+            };
+        });
+    };
+});
+
+exports.getGroupMessageStatusFactory = getGroupMessageStatusFactory;

package/dist/cjs/apis.cjs

@@ -83,12 +83,16 @@ var getFullAvatar = require('./apis/profile/getFullAvatar.cjs');
 var getGroupBlockedMember = require('./apis/group/getGroupBlockedMember.cjs');
 var getGroupChatHistory = require('./apis/group/getGroupChatHistory.cjs');
 var getGroupCloudMessageJump = require('./apis/group/getGroupCloudMessageJump.cjs');
+var getGroupHistoryLegacy = require('./apis/group/getGroupHistoryLegacy.cjs');
 var getGroupInfo = require('./apis/group/getGroupInfo.cjs');
+var getGroupInfoV2 = require('./apis/group/getGroupInfoV2.cjs');
 var getGroupInviteBoxInfo = require('./apis/group/getGroupInviteBoxInfo.cjs');
 var getGroupInviteBoxList = require('./apis/group/getGroupInviteBoxList.cjs');
 var getGroupLinkDetail = require('./apis/group/getGroupLinkDetail.cjs');
 var getGroupLinkInfo = require('./apis/group/getGroupLinkInfo.cjs');
+var getGroupListV3 = require('./apis/group/getGroupListV3.cjs');
 var getGroupMembersInfo = require('./apis/group/getGroupMembersInfo.cjs');
+var getGroupMessageStatus = require('./apis/group/getGroupMessageStatus.cjs');
 var getHiddenConversations = require('./apis/chat/getHiddenConversations.cjs');
 var getLabels = require('./apis/business/getLabels.cjs');
 var getLastReadContactTab = require('./apis/friend/getLastReadContactTab.cjs');
@@ -419,12 +423,16 @@ class API {
                 get getGroupBlockedMember() { return api.getGroupBlockedMember; },
                 get getGroupChatHistory() { return api.getGroupChatHistory; },
                 get getGroupCloudMessageJump() { return api.getGroupCloudMessageJump; },
+                get getGroupHistoryLegacy() { return api.getGroupHistoryLegacy; },
                 get getGroupInfo() { return api.getGroupInfo; },
+                get getGroupInfoV2() { return api.getGroupInfoV2; },
                 get getGroupInviteBoxInfo() { return api.getGroupInviteBoxInfo; },
                 get getGroupInviteBoxList() { return api.getGroupInviteBoxList; },
                 get getGroupLinkDetail() { return api.getGroupLinkDetail; },
                 get getGroupLinkInfo() { return api.getGroupLinkInfo; },
+                get getGroupListV3() { return api.getGroupListV3; },
                 get getGroupMembersInfo() { return api.getGroupMembersInfo; },
+                get getGroupMessageStatus() { return api.getGroupMessageStatus; },
                 get getPendingGroupMembers() { return api.getPendingGroupMembers; },
                 get getQuotaCommunity() { return api.getQuotaCommunity; },
                 get getRelatedFriendGroup() { return api.getRelatedFriendGroup; },
@@ -774,9 +782,15 @@ class API {
     get getGroupCloudMessageJump() {
         return (this._cache.getGroupCloudMessageJump ??= getGroupCloudMessageJump.getGroupCloudMessageJumpFactory(this.ctx, this));
     }
+    get getGroupHistoryLegacy() {
+        return (this._cache.getGroupHistoryLegacy ??= getGroupHistoryLegacy.getGroupHistoryLegacyFactory(this.ctx, this));
+    }
     get getGroupInfo() {
         return (this._cache.getGroupInfo ??= getGroupInfo.getGroupInfoFactory(this.ctx, this));
     }
+    get getGroupInfoV2() {
+        return (this._cache.getGroupInfoV2 ??= getGroupInfoV2.getGroupInfoV2Factory(this.ctx, this));
+    }
     get getGroupInviteBoxInfo() {
         return (this._cache.getGroupInviteBoxInfo ??= getGroupInviteBoxInfo.getGroupInviteBoxInfoFactory(this.ctx, this));
     }
@@ -789,9 +803,15 @@ class API {
     get getGroupLinkInfo() {
         return (this._cache.getGroupLinkInfo ??= getGroupLinkInfo.getGroupLinkInfoFactory(this.ctx, this));
     }
+    get getGroupListV3() {
+        return (this._cache.getGroupListV3 ??= getGroupListV3.getGroupListV3Factory(this.ctx, this));
+    }
     get getGroupMembersInfo() {
         return (this._cache.getGroupMembersInfo ??= getGroupMembersInfo.getGroupMembersInfoFactory(this.ctx, this));
     }
+    get getGroupMessageStatus() {
+        return (this._cache.getGroupMessageStatus ??= getGroupMessageStatus.getGroupMessageStatusFactory(this.ctx, this));
+    }
     get getHiddenConversations() {
         return (this._cache.getHiddenConversations ??= getHiddenConversations.getHiddenConversationsFactory(this.ctx, this));
     }

package/dist/cjs/constants/endpoints.cjs

@@ -66,6 +66,19 @@ const ZALO_ENDPOINTS = {
         LIST: "/api/recentsearch/list",
         UPDATE: "/api/recentsearch/update",
     },
+    GROUP: {
+        GET_LIST_V3: "/api/group/getlg/v3",
+        GET_LIST_V4: "/api/group/getlg/v4",
+        GET_INFO_V1: "/api/group/getgi",
+        GET_INFO_V2: "/api/group/getgi/v2",
+        GET_MULTI_INFO_V1: "/api/group/getmg",
+        GET_MULTI_INFO_V2: "/api/group/getmg-v2",
+        GET_STATUS_MSG: "/api/group/getStatusMsg",
+        HISTORY_LEGACY: "/api/group/history",
+        CLOUD_MSG_RECENT_V2: "/api/cm/getrecentv2",
+        CLOUD_MSG_OLD_V2: "/api/cm/getoldv2",
+        CLOUD_MSG_JUMP_V2: "/api/cm/rgetv2",
+    },
 };
 
 exports.ZALO_ENDPOINTS = ZALO_ENDPOINTS;

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.2",
+    SDK_VERSION: "2.3.3",
     /** 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

@@ -36,13 +36,7 @@ var zalo = require('./zalo.cjs');
 var types = require('./realtime/types.cjs');
 require('events');
 require('ws');
-require('crypto-js');
-require('node:crypto');
-require('node:fs');
-require('node:path');
-require('spark-md5');
-require('tough-cookie');
-require('./context.cjs');
+var utils = require('./utils.cjs');
 var loginQR = require('./apis/loginQR.cjs');
 var getFriendRecommendations = require('./apis/friend/getFriendRecommendations.cjs');
 var reviewPendingMemberRequest = require('./apis/group/reviewPendingMemberRequest.cjs');
@@ -171,6 +165,7 @@ Object.defineProperty(exports, "CloseReason", {
 	enumerable: true,
 	get: function () { return types.CloseReason; }
 });
+exports.preParseJsonIds = utils.preParseJsonIds;
 Object.defineProperty(exports, "LoginQRCallbackEventType", {
 	enumerable: true,
 	get: function () { return loginQR.LoginQRCallbackEventType; }

package/dist/cjs/utils.cjs

@@ -452,6 +452,67 @@ function getFriendEventType(act) {
         return FriendEvent.FriendEventType.PIN_CREATE;
     return FriendEvent.FriendEventType.UNKNOWN;
 }
+const DEFAULT_BIGINT_ID_FIELDS = [
+    "owner_id",
+    "group_id",
+    "uidFrom",
+    "uidTo",
+    "uid",
+    "ownerId",
+    "destId",
+    "srcId",
+    "fromUid",
+    "threadId",
+    "globalMsgId",
+    "global_msg_id",
+    "globalDelMsgId",
+    "msgId",
+    "refMessageId",
+    "cliMsgId",
+    "client_msg_id",
+    "actionId",
+    "lastActionIdOther",
+    "lastActionId",
+    "resetLastActionId",
+    "lastId",
+    "ids",
+    "topicId",
+    "reminderId",
+    "eventId",
+];
+/**
+ * Tiền xử lý chuỗi JSON trước khi `JSON.parse` (tương đương `preParse(e, t)` trong `app.asar` của Zalo PC).
+ * Bọc dấu ngoặc kép quanh các trường định danh 64-bit (`owner_id`, `group_id`, hoặc các số nguyên >= 16 chữ số
+ * vượt quá `Number.MAX_SAFE_INTEGER`) để tránh mất 3 chữ số cuối của UID/MsgId do làm tròn IEEE-754.
+ */
+function preParseJsonIds(jsonStr, alwaysStringFields = ["owner_id", "group_id"], bigIntSafeFields = DEFAULT_BIGINT_ID_FIELDS) {
+    if (!jsonStr || typeof jsonStr !== "string")
+        return jsonStr;
+    const alwaysSet = new Set(alwaysStringFields);
+    const allFields = Array.from(new Set([...alwaysStringFields, ...bigIntSafeFields]));
+    if (allFields.length === 0)
+        return jsonStr;
+    const escapedKeys = allFields.map((k) => k.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+    const keyValueRegex = new RegExp(`"(${escapedKeys})"(\\s*:\\s*)(\\d+|\\[\\s*\\d+(?:\\s*,\\s*\\d+)*\\s*\\])`, "g");
+    return jsonStr.replace(keyValueRegex, (fullMatch, key, sep, rawVal) => {
+        const forceString = alwaysSet.has(key);
+        if (rawVal.startsWith("[")) {
+            const inner = rawVal.slice(1, -1);
+            const parts = inner.split(",").map((part) => {
+                const trimmed = part.trim();
+                if (forceString || trimmed.length >= 16 || Number(trimmed) > Number.MAX_SAFE_INTEGER) {
+                    return `"${trimmed}"`;
+                }
+                return trimmed;
+            });
+            return `"${key}"${sep}[${parts.join(",")}]`;
+        }
+        if (forceString || rawVal.length >= 16 || Number(rawVal) > Number.MAX_SAFE_INTEGER) {
+            return `"${key}"${sep}"${rawVal}"`;
+        }
+        return fullMatch;
+    });
+}
 async function handleZaloResponse(ctx, response, isEncrypted = true) {
     const result = {
         data: null,
@@ -481,7 +542,8 @@ async function handleZaloResponse(ctx, response, isEncrypted = true) {
             result.data = {};
             return result;
         }
-        const decodedData = isEncrypted ? JSON.parse(decodedStr) : jsonData;
+        const safeJsonStr = isEncrypted ? preParseJsonIds(decodedStr) : null;
+        const decodedData = isEncrypted ? JSON.parse(safeJsonStr) : jsonData;
         if (decodedData.error_code != 0) {
             result.error = {
                 message: decodedData.error_message,
@@ -554,6 +616,7 @@ exports.decryptResp = aes.decryptResp;
 exports.encodeAES = aes.encodeAES;
 exports.encryptPin = aes.encryptPin;
 exports.validatePin = aes.validatePin;
+exports.DEFAULT_BIGINT_ID_FIELDS = DEFAULT_BIGINT_ID_FIELDS;
 exports.apiFactory = apiFactory;
 exports.formatTime = formatTime;
 exports.generateZaloUUID = generateZaloUUID;
@@ -579,6 +642,7 @@ exports.isBun = isBun;
 exports.logger = logger;
 exports.makeURL = makeURL;
 exports.normalizeHolderName = normalizeHolderName;
+exports.preParseJsonIds = preParseJsonIds;
 exports.removeUndefinedKeys = removeUndefinedKeys;
 exports.request = request;
 exports.resolveResponse = resolveResponse;

package/dist/constants/endpoints.d.ts

@@ -64,4 +64,17 @@ export declare const ZALO_ENDPOINTS: {
         readonly LIST: "/api/recentsearch/list";
         readonly UPDATE: "/api/recentsearch/update";
     };
+    readonly GROUP: {
+        readonly GET_LIST_V3: "/api/group/getlg/v3";
+        readonly GET_LIST_V4: "/api/group/getlg/v4";
+        readonly GET_INFO_V1: "/api/group/getgi";
+        readonly GET_INFO_V2: "/api/group/getgi/v2";
+        readonly GET_MULTI_INFO_V1: "/api/group/getmg";
+        readonly GET_MULTI_INFO_V2: "/api/group/getmg-v2";
+        readonly GET_STATUS_MSG: "/api/group/getStatusMsg";
+        readonly HISTORY_LEGACY: "/api/group/history";
+        readonly CLOUD_MSG_RECENT_V2: "/api/cm/getrecentv2";
+        readonly CLOUD_MSG_OLD_V2: "/api/cm/getoldv2";
+        readonly CLOUD_MSG_JUMP_V2: "/api/cm/rgetv2";
+    };
 };

package/dist/constants/endpoints.js

@@ -64,4 +64,17 @@ export const ZALO_ENDPOINTS = {
         LIST: "/api/recentsearch/list",
         UPDATE: "/api/recentsearch/update",
     },
+    GROUP: {
+        GET_LIST_V3: "/api/group/getlg/v3",
+        GET_LIST_V4: "/api/group/getlg/v4",
+        GET_INFO_V1: "/api/group/getgi",
+        GET_INFO_V2: "/api/group/getgi/v2",
+        GET_MULTI_INFO_V1: "/api/group/getmg",
+        GET_MULTI_INFO_V2: "/api/group/getmg-v2",
+        GET_STATUS_MSG: "/api/group/getStatusMsg",
+        HISTORY_LEGACY: "/api/group/history",
+        CLOUD_MSG_RECENT_V2: "/api/cm/getrecentv2",
+        CLOUD_MSG_OLD_V2: "/api/cm/getoldv2",
+        CLOUD_MSG_JUMP_V2: "/api/cm/rgetv2",
+    },
 };

package/dist/constants/protocol.d.ts

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

package/dist/constants/protocol.js

@@ -10,7 +10,7 @@ export const ZALO_PROTOCOL = {
     API_VERSION: 689,
     DEFAULT_API_VERSION: 689,
     /** Phiên bản SDK hiện tại */
-    SDK_VERSION: "2.3.2",
+    SDK_VERSION: "2.3.3",
     /** 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) */