@softtynet/zca-js 2.3.1 → 2.3.3

package/dist/index.d.ts

@@ -68,8 +68,12 @@ export type { GetFriendRecommendationsResponse, FriendRecommendationsCollapseMsg
 export type { GetFriendRequestStatusResponse } from "./apis/friend/getFriendRequestStatus.js";
 export type { GetFullAvatarResponse } from "./apis/profile/getFullAvatar.js";
 export type { GetGroupBlockedMemberPayload, GetGroupBlockedMemberResponse } from "./apis/group/getGroupBlockedMember.js";
-export type { GetGroupChatHistoryResponse } from "./apis/group/getGroupChatHistory.js";
+export type { GetGroupChatHistoryOptions, GetGroupChatHistoryResponse } from "./apis/group/getGroupChatHistory.js";
+export type { GetGroupHistoryLegacyResponse } from "./apis/group/getGroupHistoryLegacy.js";
 export type { GroupInfoPendingApprove, GroupInfoResponse } from "./apis/group/getGroupInfo.js";
+export type { GetGroupInfoV2Options, GetGroupInfoV2Response } from "./apis/group/getGroupInfoV2.js";
+export type { GetGroupListV3Options, GetGroupListV3Response } from "./apis/group/getGroupListV3.js";
+export type { GetGroupMessageStatusQueryItem, GetGroupMessageStatusResponse, GroupMessageStatusMemberItem, GroupMessageStatusThreadInfo, } from "./apis/group/getGroupMessageStatus.js";
 export type { GetGroupInviteBoxInfoPayload, GetGroupInviteBoxInfoResponse } from "./apis/group/getGroupInviteBoxInfo.js";
 export type { GetGroupInviteBoxListPayload, GetGroupInviteBoxListResponse } from "./apis/group/getGroupInviteBoxList.js";
 export type { GetGroupLinkDetailResponse } from "./apis/group/getGroupLinkDetail.js";
@@ -176,7 +180,7 @@ export type { GetBlockFriendsResponse } from "./apis/friend/getBlockFriends.js";
 export type { GetCloudInfoResponse } from "./apis/zcloud/getCloudInfo.js";
 export type { GetCloudSettingsResponse } from "./apis/zcloud/getCloudSettings.js";
 export type { GetCloudViewerKeyResponse } from "./apis/zcloud/getCloudViewerKey.js";
-export type { GetConversationMediaOptions, GetConversationMediaResponse } from "./apis/media/getConversationMedia.js";
+export type { GetConversationMediaOptions, GetConversationMediaResponse, MediaStoreItem, MediaStoreType, } from "./apis/media/getConversationMedia.js";
 export type { GetEmojiStatusConfigResponse } from "./apis/profile/getEmojiStatusConfig.js";
 export type { GetExtraFriendInfoResponse } from "./apis/friend/getExtraFriendInfo.js";
 export type { GetExtraGroupInfoResponse } from "./apis/group/getExtraGroupInfo.js";
@@ -221,4 +225,4 @@ export { ChatTTL } from "./apis/chat/updateAutoDeleteChat.js";
 export { UpdateLangAvailableLanguages } from "./apis/auth/updateLang.js";
 export { UpdateSettingsType } from "./apis/profile/updateSettings.js";
 export { CallType } from "./apis/call/sendVoiceCall.js";
-export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, type ZdbTocEntry, } from "./utils.js";
+export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, preParseJsonIds, type ZdbTocEntry, } from "./utils.js";

package/dist/index.js

@@ -16,4 +16,4 @@ export { ChatTTL } from "./apis/chat/updateAutoDeleteChat.js";
 export { UpdateLangAvailableLanguages } from "./apis/auth/updateLang.js";
 export { UpdateSettingsType } from "./apis/profile/updateSettings.js";
 export { CallType } from "./apis/call/sendVoiceCall.js";
-export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, } from "./utils.js";
+export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, preParseJsonIds, } from "./utils.js";

package/dist/utils.d.ts

@@ -112,6 +112,13 @@ export type ZaloResponse<T> = {
         code?: number;
     } | null;
 };
+export declare const DEFAULT_BIGINT_ID_FIELDS: readonly ["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.
+ */
+export declare function preParseJsonIds(jsonStr: string, alwaysStringFields?: readonly string[], bigIntSafeFields?: readonly string[]): string;
 export declare function handleZaloResponse<T = unknown>(ctx: ContextSession, response: Response, isEncrypted?: boolean): Promise<ZaloResponse<T>>;
 export declare function resolveResponse<T = unknown>(ctx: ContextSession, res: Response, cb?: (result: ZaloResponse<unknown>) => T, isEncrypted?: boolean): Promise<T>;
 export type FactoryUtils<T> = {

package/dist/utils.js

@@ -447,6 +447,67 @@ export function getFriendEventType(act) {
         return FriendEventType.PIN_CREATE;
     return FriendEventType.UNKNOWN;
 }
+export 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.
+ */
+export 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;
+    });
+}
 export async function handleZaloResponse(ctx, response, isEncrypted = true) {
     const result = {
         data: null,
@@ -476,7 +537,8 @@ export 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,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@softtynet/zca-js",
-    "version": "2.3.1",
+    "version": "2.3.3",
     "description": "Zalo API client library for Node.js and Bun, maintained by Softtynet.",
     "main": "dist/index.js",
     "type": "module",