@softtynet/zca-js 2.3.3 → 2.3.5

package/dist/cjs/models/CallEvent.cjs

@@ -4,11 +4,24 @@ exports.CallEventType = void 0;
 (function (CallEventType) {
     CallEventType["REQUEST"] = "request";
     CallEventType["ANSWER"] = "answer";
+    CallEventType["ANSWER_ACK"] = "answer_ack";
     CallEventType["CANCEL"] = "cancel";
     CallEventType["END"] = "end";
     CallEventType["RINGRING"] = "ringring";
+    CallEventType["ONOFF_CAMERA"] = "onoff_camera";
+    CallEventType["MUTE_AUDIO"] = "mute_audio";
+    CallEventType["AUDIO_TO_VIDEO"] = "audio_to_video";
+    CallEventType["SHARE_SCREEN"] = "share_screen";
     CallEventType["GROUP_REQUEST"] = "group_request";
+    CallEventType["GROUP_RINGRING"] = "group_ring_ring";
     CallEventType["GROUP_ANSWER"] = "group_answer";
+    CallEventType["GROUP_ANSWER_ACK"] = "group_answer_ack";
+    CallEventType["GROUP_CANCEL"] = "group_cancel";
+    CallEventType["GROUP_END"] = "group_end_call";
+    CallEventType["GROUP_ADD_USER"] = "group_add_user";
+    CallEventType["GROUP_NOTIFY"] = "group_notify";
+    CallEventType["GROUP_BROADCAST"] = "group_broadcast";
+    CallEventType["GROUP_BROADCAST_CONFIG"] = "group_broadcast_config";
     CallEventType["UNKNOWN"] = "unknown";
 })(exports.CallEventType || (exports.CallEventType = {}));
 function initializeCallEvent(data, act, act_type) {
@@ -20,31 +33,112 @@ function initializeCallEvent(data, act, act_type) {
         case "answer":
             type = exports.CallEventType.ANSWER;
             break;
+        case "answer_ack":
+        case "answerack":
+            type = exports.CallEventType.ANSWER_ACK;
+            break;
         case "cancel":
             type = exports.CallEventType.CANCEL;
             break;
         case "end":
         case "endcall":
+        case "end_call":
             type = exports.CallEventType.END;
             break;
         case "ringring":
+        case "ring_ring":
             type = exports.CallEventType.RINGRING;
             break;
+        case "onoff_camera":
+            type = exports.CallEventType.ONOFF_CAMERA;
+            break;
+        case "mute_audio":
+            type = exports.CallEventType.MUTE_AUDIO;
+            break;
+        case "audio_to_video":
+            type = exports.CallEventType.AUDIO_TO_VIDEO;
+            break;
+        case "share_screen":
+            type = exports.CallEventType.SHARE_SCREEN;
+            break;
         case "group_request":
             type = exports.CallEventType.GROUP_REQUEST;
             break;
+        case "group_ring_ring":
+        case "group_ringring":
+            type = exports.CallEventType.GROUP_RINGRING;
+            break;
         case "group_answer":
             type = exports.CallEventType.GROUP_ANSWER;
             break;
+        case "group_answer_ack":
+            type = exports.CallEventType.GROUP_ANSWER_ACK;
+            break;
+        case "group_cancel":
+            type = exports.CallEventType.GROUP_CANCEL;
+            break;
+        case "group_end_call":
+        case "group_endcall":
+        case "group_end":
+            type = exports.CallEventType.GROUP_END;
+            break;
+        case "group_add_user":
+            type = exports.CallEventType.GROUP_ADD_USER;
+            break;
+        case "group_notify":
+            type = exports.CallEventType.GROUP_NOTIFY;
+            break;
+        case "group_broadcast":
+            type = exports.CallEventType.GROUP_BROADCAST;
+            break;
+        case "group_broadcast_config":
+            type = exports.CallEventType.GROUP_BROADCAST_CONFIG;
+            break;
         default:
             type = exports.CallEventType.UNKNOWN;
             break;
     }
+    const enrichedData = { ...data };
+    let parsedParams;
+    if (typeof enrichedData.params === "string") {
+        try {
+            const p = JSON.parse(enrichedData.params);
+            if (p && typeof p === "object")
+                parsedParams = p;
+        }
+        catch {
+            // Ignore invalid JSON
+        }
+    }
+    else if (enrichedData.params && typeof enrichedData.params === "object") {
+        parsedParams = enrichedData.params;
+    }
+    if (enrichedData.callId === undefined) {
+        const extractedCallId = Number(enrichedData.call_id ??
+            enrichedData.id ??
+            parsedParams?.callId ??
+            parsedParams?.call_id ??
+            parsedParams?.id ??
+            0);
+        if (extractedCallId > 0) {
+            enrichedData.callId = extractedCallId;
+        }
+    }
+    if (enrichedData.callerId === undefined) {
+        const extractedCallerId = enrichedData.uidN ??
+            parsedParams?.uidN ??
+            enrichedData.uidFrom ??
+            enrichedData.fromId ??
+            parsedParams?.uidFrom;
+        if (extractedCallerId !== undefined) {
+            enrichedData.callerId = String(extractedCallerId);
+        }
+    }
     return {
         type,
         act,
         act_type,
-        data,
+        data: enrichedData,
     };
 }
 

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

@@ -8,10 +8,15 @@ 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 && subCmd == 0) {
-        const parsedData = (await wsCipher.decodeEventData(parsed, cipherKey)).data;
-        const { controls } = parsedData;
+    if (version == 1 && (cmd == 601 || cmd == 603 || cmd == 604) && subCmd == 0) {
+        const decoded = await wsCipher.decodeEventData(parsed, cipherKey);
+        const parsedData = decoded?.data;
+        const controls = parsedData?.controls;
+        if (!Array.isArray(controls))
+            return false;
         for (const control of controls) {
+            if (!control?.content)
+                continue;
             if (control.content.act_type == "file_done") {
                 const data = {
                     fileUrl: control.content.data.url,
@@ -62,6 +67,15 @@ async function handleRealtimeControlPacket(listener, ctx, selfListen, version, c
                 const callEventData = typeof control.content.data == "string"
                     ? JSON.parse(control.content.data)
                     : control.content.data;
+                // Bỏ qua các gói mời gọi cũ (> 60s) nằm trong hàng đợi offline (cmd 603 / 604)
+                if ((cmd == 603 || cmd == 604) &&
+                    (control.content.act == "request" || control.content.act == "group_request") &&
+                    callEventData?.ts) {
+                    const eventTs = Number.parseInt(String(callEventData.ts), 10);
+                    if (Number.isFinite(eventTs) && Date.now() - eventTs > 60_000) {
+                        continue;
+                    }
+                }
                 const callEvent = CallEvent.initializeCallEvent(callEventData, control.content.act, control.content.act_type);
                 listener.emit("call_event", callEvent);
             }

package/dist/cjs/realtime/listener.cjs

@@ -43,6 +43,7 @@ class Listener extends EventEmitter {
     retryTimeout;
     watchdogTimeout;
     consecutive1006Count = 0;
+    isManualStop = false;
     id = 0;
     constructor(ctx, urls) {
         super();
@@ -168,6 +169,7 @@ class Listener extends EventEmitter {
         utils.logger(this.ctx).verbose(`Rotating endpoint to ${this.wsURL}`);
     }
     start({ retryOnClose = false } = {}) {
+        this.isManualStop = false;
         if (this.retryTimeout) {
             clearTimeout(this.retryTimeout);
             this.retryTimeout = undefined;
@@ -191,6 +193,10 @@ class Listener extends EventEmitter {
             t: Date.now(),
         });
         const cookie = this.ctx.cookie.getCookieStringSync(domains.ZALO_DOMAINS.CHAT_WEB);
+        const wsAgent = this.ctx.options.agent &&
+            typeof this.ctx.options.agent.dispatch !== "function"
+            ? this.ctx.options.agent
+            : undefined;
         const ws = new WebSocket(this.wsURL, {
             headers: {
                 "accept-language": utils.getBrowserLanguage(this.ctx.language),
@@ -205,7 +211,7 @@ class Listener extends EventEmitter {
                 "user-agent": this.userAgent,
                 cookie,
             },
-            agent: this.ctx.options.agent,
+            ...(wsAgent ? { agent: wsAgent } : {}),
         });
         this.ws = ws;
         ws.onopen = () => {
@@ -218,7 +224,8 @@ class Listener extends EventEmitter {
         ws.onclose = (event) => {
             this.reset();
             this.emit("disconnected", event.code, event.reason);
-            const retry = retryOnClose &&
+            const retry = !this.isManualStop &&
+                retryOnClose &&
                 this.isRetryable(event.code) &&
                 this.canRetry(event.code);
             if (retry && retryOnClose) {
@@ -262,6 +269,7 @@ class Listener extends EventEmitter {
                 if (version == 1 && cmd == 1 && subCmd == 1 && utils.hasOwn(parsed, "key")) {
                     this.cipherKey = parsed.key;
                     this.emit("cipher_key", this.cipherKey);
+                    this.requestOfflineVoipControls();
                     if (this.pingInterval)
                         clearInterval(this.pingInterval);
                     const ping = () => {
@@ -304,19 +312,24 @@ class Listener extends EventEmitter {
         };
     }
     stop() {
-        if (this.retryTimeout)
+        this.isManualStop = true;
+        if (this.retryTimeout) {
             clearTimeout(this.retryTimeout);
-        if (this.watchdogTimeout)
+            this.retryTimeout = undefined;
+        }
+        if (this.watchdogTimeout) {
             clearTimeout(this.watchdogTimeout);
+            this.watchdogTimeout = undefined;
+        }
         if (this.ws) {
-            if (this.ws.readyState !== WebSocket.CLOSED) {
+            if (this.ws.readyState !== WebSocket.CLOSED && this.ws.readyState !== WebSocket.CLOSING) {
                 this.ws.close(types.CloseReason.ManualClosure);
             }
         }
         this.reset();
     }
     sendWs(payload, requireId = true) {
-        if (this.ws) {
+        if (this.ws && (this.ws.readyState === undefined || this.ws.readyState === WebSocket.OPEN)) {
             if (requireId)
                 payload.data["req_id"] = `req_${this.id++}`;
             const encodedData = new TextEncoder().encode(JSON.stringify(payload.data));
@@ -362,6 +375,24 @@ class Listener extends EventEmitter {
         };
         this.sendWs(payload);
     }
+    /**
+     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL và `cmd 604` CTRL_PULL_VOIP).
+     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông ngay cả khi vừa mở kết nối WebSocket.
+     */
+    requestOfflineVoipControls() {
+        this.sendWs({
+            version: 1,
+            cmd: 604,
+            subCmd: 0,
+            data: { first: true, lastId: 1, preIds: [] },
+        });
+        this.sendWs({
+            version: 1,
+            cmd: 603,
+            subCmd: 0,
+            data: { first: true, lastId: "1", preIds: [] },
+        });
+    }
     reset() {
         this.ws = null;
         this.cipherKey = undefined;

package/dist/cjs/update.cjs

@@ -10,6 +10,9 @@ const NPM_REGISTRY = domains.ZALO_DOMAINS.NPM_REGISTRY;
 async function checkUpdate(ctx) {
     if (!ctx.options.checkUpdate)
         return;
+    const isAgentUndiciDispatcher = Boolean(ctx.options.agent && typeof ctx.options.agent.dispatch === "function");
+    const resolvedDispatcher = ctx.options.dispatcher ?? (isAgentUndiciDispatcher ? ctx.options.agent : undefined);
+    const resolvedAgent = ctx.options.agent && !isAgentUndiciDispatcher ? ctx.options.agent : undefined;
     const _options = {
         ...(utils.isBun
             ? {
@@ -17,7 +20,13 @@ async function checkUpdate(ctx) {
                 // @ts-ignore
                 proxy: ctx.options.agent?.proxy?.href,
             }
-            : { agent: ctx.options.agent }),
+            : {
+                ...(resolvedAgent ? { agent: resolvedAgent } : {}),
+                ...(resolvedDispatcher ? { dispatcher: resolvedDispatcher } : {}),
+            }),
+        ...(typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function"
+            ? { signal: AbortSignal.timeout(3000) }
+            : {}),
     };
     const response = await ctx.options.polyfill(NPM_REGISTRY, _options).catch(() => null);
     if (!response || !response.ok)

package/dist/cjs/utils.cjs

@@ -15,8 +15,7 @@ var protocol = require('./constants/protocol.cjs');
 var domains = require('./constants/domains.cjs');
 var defaults = require('./constants/defaults.cjs');
 var aes = require('./crypto/aes.cjs');
-require('pako');
-require('json-bigint');
+var wsCipher = require('./crypto/ws-cipher.cjs');
 
 const isBun = typeof Bun !== "undefined";
 function hasOwn(obj, key) {
@@ -166,8 +165,20 @@ async function request(ctx, url, options, raw = false) {
             options = { ...(options || {}), headers: defaultHeaders };
         }
     }
+    const timeoutMs = ctx.options?.requestTimeout;
+    const defaultSignal = !options?.signal &&
+        typeof timeoutMs === "number" &&
+        timeoutMs > 0 &&
+        typeof AbortSignal !== "undefined" &&
+        typeof AbortSignal.timeout === "function"
+        ? AbortSignal.timeout(timeoutMs)
+        : undefined;
+    const isAgentUndiciDispatcher = Boolean(ctx.options.agent && typeof ctx.options.agent.dispatch === "function");
+    const resolvedDispatcher = ctx.options.dispatcher ?? (isAgentUndiciDispatcher ? ctx.options.agent : undefined);
+    const resolvedAgent = ctx.options.agent && !isAgentUndiciDispatcher ? ctx.options.agent : undefined;
     const _options = {
         ...(options ?? {}),
+        ...(defaultSignal ? { signal: defaultSignal } : {}),
         ...(isBun
             ? {
                 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -175,8 +186,8 @@ async function request(ctx, url, options, raw = false) {
                 proxy: ctx.options.agent?.proxy?.href,
             }
             : {
-                agent: ctx.options.agent,
-                dispatcher: ctx.options.agent,
+                ...(resolvedAgent ? { agent: resolvedAgent } : {}),
+                ...(resolvedDispatcher ? { dispatcher: resolvedDispatcher } : {}),
             }),
     };
     const response = await ctx.options.polyfill(url, _options);
@@ -452,67 +463,6 @@ 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,
@@ -542,7 +492,7 @@ async function handleZaloResponse(ctx, response, isEncrypted = true) {
             result.data = {};
             return result;
         }
-        const safeJsonStr = isEncrypted ? preParseJsonIds(decodedStr) : null;
+        const safeJsonStr = isEncrypted ? wsCipher.preParseJsonIds(decodedStr) : null;
         const decodedData = isEncrypted ? JSON.parse(safeJsonStr) : jsonData;
         if (decodedData.error_code != 0) {
             result.error = {
@@ -616,7 +566,11 @@ 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.DEFAULT_BIGINT_ID_FIELDS = wsCipher.DEFAULT_BIGINT_ID_FIELDS;
+exports.decodeBase64ToBuffer = wsCipher.decodeBase64ToBuffer;
+exports.decodeEventData = wsCipher.decodeEventData;
+exports.decodeUnit8Array = wsCipher.decodeUnit8Array;
+exports.preParseJsonIds = wsCipher.preParseJsonIds;
 exports.apiFactory = apiFactory;
 exports.formatTime = formatTime;
 exports.generateZaloUUID = generateZaloUUID;
@@ -642,7 +596,6 @@ 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/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.3";
+    readonly SDK_VERSION: "2.3.5";
     /** 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.3",
+    SDK_VERSION: "2.3.5",
     /** 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/context.d.ts

@@ -154,18 +154,28 @@ export type Options = {
     apiType: number;
     apiVersion: number;
     agent?: Agent;
+    /**
+     * Bộ điều phối kết nối (Undici `Dispatcher` / `ProxyAgent`) dành cho `globalThis.fetch` mặc định của Node.js 18+.
+     */
+    dispatcher?: unknown;
     /**
      * Optional fetch implementation for polyfills in non-standard environments.
      * If using proxy, `node-fetch` is highly recommended.
      */
     polyfill: typeof fetch;
     imageMetadataGetter?: ImageMetadataGetter;
+    /**
+     * Thời gian chờ tối đa cho mỗi HTTP request tính bằng mili-giây (mặc định: `30000`ms = 30s, đặt `0` để tắt).
+     */
+    requestTimeout?: number;
 };
 declare class CallbacksMap extends Map<string, UploadCallback> {
+    private timers;
     /**
      * @param ttl Time to live in milliseconds. Default is 5 minutes.
      */
     set(key: string, value: UploadCallback, ttl?: number): this;
+    delete(key: string): boolean;
 }
 export type ViewerKeyCacheEntry = {
     viewer_key: string;

package/dist/context.js

@@ -1,15 +1,32 @@
 import { ZALO_DEFAULTS, ZALO_PROTOCOL } from "./constants/index.js";
 const _5_MINUTES = ZALO_DEFAULTS.UPLOAD.CALLBACK_TTL_MS;
 class CallbacksMap extends Map {
+    timers = new Map();
     /**
      * @param ttl Time to live in milliseconds. Default is 5 minutes.
      */
     set(key, value, ttl = _5_MINUTES) {
-        setTimeout(() => {
-            this.delete(key);
+        const existing = this.timers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.timers.delete(key);
+            super.delete(key);
         }, ttl);
+        if (typeof timer === "object" && timer !== null && "unref" in timer && typeof timer.unref === "function") {
+            timer.unref();
+        }
+        this.timers.set(key, timer);
         return super.set(key, value);
     }
+    delete(key) {
+        const existing = this.timers.get(key);
+        if (existing) {
+            clearTimeout(existing);
+            this.timers.delete(key);
+        }
+        return super.delete(key);
+    }
 }
 export const createContext = (apiType = ZALO_PROTOCOL.API_TYPE, apiVersion = ZALO_PROTOCOL.API_VERSION) => ({
     API_TYPE: apiType,
@@ -20,6 +37,7 @@ export const createContext = (apiType = ZALO_PROTOCOL.API_TYPE, apiVersion = ZAL
         checkUpdate: ZALO_DEFAULTS.OPTIONS.CHECK_UPDATE,
         logging: ZALO_DEFAULTS.OPTIONS.LOGGING,
         polyfill: global.fetch,
+        requestTimeout: 30000,
     },
     secretKey: null,
 });

package/dist/crypto/ws-cipher.d.ts

@@ -1,3 +1,10 @@
+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 decodeBase64ToBuffer(data: string): Buffer;
 export declare function decodeUnit8Array(data: Uint8Array): string | null;
 export declare function decodeEventData(parsed: Record<string, unknown>, cipherKey?: string): Promise<any>;

package/dist/crypto/ws-cipher.js

@@ -2,6 +2,68 @@ import crypto from "node:crypto";
 import pako from "pako";
 import JSONBig from "json-bigint";
 import { ZaloApiError } from "../Errors/index.js";
+const jsonBigString = JSONBig({ storeAsString: true });
+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 function decodeBase64ToBuffer(data) {
     return Buffer.from(data, "base64");
 }
@@ -23,7 +85,7 @@ export async function decodeEventData(parsed, cipherKey) {
     const rawData = parsed.data;
     const encryptType = parsed.encrypt;
     if (encryptType === 0)
-        return JSON.parse(rawData);
+        return jsonBigString.parse(preParseJsonIds(rawData));
     const decodedBuffer = decodeBase64ToBuffer(encryptType === 1 ? rawData : decodeURIComponent(rawData));
     let decryptedBuffer = decodedBuffer;
     if (encryptType !== 1) {
@@ -48,5 +110,5 @@ export async function decodeEventData(parsed, cipherKey) {
     const decodedData = decodeUnit8Array(decompressedBuffer);
     if (!decodedData)
         return;
-    return JSONBig.parse(decodedData);
+    return jsonBigString.parse(preParseJsonIds(decodedData));
 }