@softtynet/zca-js 2.3.3 → 2.3.5

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./models/index.js";
 export * from "./constants/index.js";
 export * from "./crypto/index.js";
 export * from "./core/index.js";
+export * from "./realtime/index.js";
 export * from "./zalo.js";
 export type { AuthDomainAPI, BoardDomainAPI, BusinessDomainAPI, CallDomainAPI, ChatDomainAPI, FriendDomainAPI, GroupDomainAPI, MediaDomainAPI, ProfileDomainAPI, StickerDomainAPI, SyncDomainAPI, ZcloudDomainAPI, } from "./apis.js";
 export type { ContextSession, ContextBase, AppContextExtended, AppContextBase, Options, ZPWServiceMap, ImageMetadataGetter, ImageMetadataGetterResponse, ViewerKeyCacheEntry } from "./context.js";
@@ -74,6 +75,21 @@ export type { GroupInfoPendingApprove, GroupInfoResponse } from "./apis/group/ge
 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 { CheckQuotaCommunityMemberResponse } from "./apis/group/checkQuotaCommunityMember.js";
+export type { GetE2eeGroupListResponse } from "./apis/group/getE2eeGroupList.js";
+export type { GetMultiGroupCloudMessagesResponse } from "./apis/group/getMultiGroupCloudMessages.js";
+export type { GetGroupCloudMessagePathOptions, GetGroupCloudMessagePathResponse } from "./apis/group/getGroupCloudMessagePath.js";
+export type { AnalyseGroupResponse } from "./apis/group/analyseGroup.js";
+export type { DirectMessageStatusItem, GetDirectMessageStatusResponse } from "./apis/chat/getDirectMessageStatus.js";
+export type { GetSuggestedConversationsResponse } from "./apis/chat/getSuggestedConversations.js";
+export type { UpdatePinConversationsOptions, UpdatePinConversationsResponse } from "./apis/chat/updatePinConversations.js";
+export type { GetFriendProfilesV2Options, GetFriendProfilesV2Response } from "./apis/friend/getFriendProfilesV2.js";
+export type { GetFriendsActivePCWebResponse } from "./apis/friend/getFriendsActivePCWeb.js";
+export type { VerifyFriendOptions, VerifyFriendResponse } from "./apis/friend/verifyFriend.js";
+export type { GetPersonalMediaOptions } from "./apis/media/getPersonalMedia.js";
+export type { GetPersonalMediaPreviewResponse } from "./apis/media/getPersonalMediaPreview.js";
+export type { RemovePersonalMediaOptions, RemovePersonalMediaResponse } from "./apis/media/removePersonalMedia.js";
+export type { ExportedSession } from "./apis/auth/exportSession.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";
@@ -85,6 +101,7 @@ export type { GetListBankResponse } from "./apis/business/getListBank.js";
 export type { GetListBankAccountResponse } from "./apis/business/getListBankAccount.js";
 export type { BoardItem, GetListBoardResponse, ListBoardOptions } from "./apis/board/getListBoard.js";
 export type { GetListDeviceResponse } from "./apis/auth/getListDevice.js";
+export type { GetListPinTopicsResponse } from "./apis/board/getListPinTopics.js";
 export type { GetListReminderResponse, ListReminderOptions, ReminderListGroup, ReminderListUser } from "./apis/board/getListReminder.js";
 export type { GetMultiUsersByPhonesResponse } from "./apis/friend/getMultiUsersByPhones.js";
 export type { GetMuteResponse, MuteEntriesInfo } from "./apis/chat/getMute.js";
@@ -145,7 +162,7 @@ export type { SendStickerResponse, SendStickerPayload } from "./apis/chat/sendSt
 export type { SendTypingEventResponse } from "./apis/chat/sendTypingEvent.js";
 export type { SendVideoOptions, SendVideoResponse } from "./apis/chat/sendVideo.js";
 export type { SendVoiceOptions, SendVoiceResponse } from "./apis/chat/sendVoice.js";
-export type { RequestCallServerInfo, SendVoiceCallOptions, SendVoiceCallResponse } from "./apis/call/sendVoiceCall.js";
+export type { RequestCallServerEntry, RequestCallServerInfo, SendVoiceCallOptions, SendVoiceCallResponse } from "./apis/call/sendVoiceCall.js";
 export type { SetHiddenConversationsResponse } from "./apis/chat/setHiddenConversations.js";
 export type { SetMuteParams, SetMuteResponse } from "./apis/chat/setMute.js";
 export type { SetPinnedConversationsResponse } from "./apis/chat/setPinnedConversations.js";
@@ -175,15 +192,15 @@ export type { VotePollResponse } from "./apis/board/votePoll.js";
 export type { CustomAPICallback, CustomAPIProps } from "./apis/custom.js";
 export type { ClearUnreadFriendRequestsResponse } from "./apis/friend/clearUnreadFriendRequests.js";
 export type { EncryptGidsResponse } from "./apis/auth/encryptGids.js";
-export type { GetAliasListV2Response } from "./apis/friend/getAliasListV2.js";
+export type { AliasItemV2, GetAliasListV2Response } from "./apis/friend/getAliasListV2.js";
 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, MediaStoreItem, MediaStoreType, } from "./apis/media/getConversationMedia.js";
-export type { GetEmojiStatusConfigResponse } from "./apis/profile/getEmojiStatusConfig.js";
+export type { EmojiStatusItem, GetEmojiStatusConfigResponse } from "./apis/profile/getEmojiStatusConfig.js";
 export type { GetExtraFriendInfoResponse } from "./apis/friend/getExtraFriendInfo.js";
-export type { GetExtraGroupInfoResponse } from "./apis/group/getExtraGroupInfo.js";
+export type { ExtraContextInfo, GetExtraGroupInfoResponse } from "./apis/group/getExtraGroupInfo.js";
 export type { GetFamilyProfileResponse } from "./apis/zcloud/getFamilyProfile.js";
 export type { GetFamilyUsageResponse } from "./apis/zcloud/getFamilyUsage.js";
 export type { GetFamilyViewerKeyResponse } from "./apis/zcloud/getFamilyViewerKey.js";
@@ -214,6 +231,31 @@ export type { UpdateRecentSearchOptions, UpdateRecentSearchResponse } from "./ap
 export type { VerifyCloudMediaOptions, VerifyCloudMediaResponse } from "./apis/zcloud/verifyCloudMedia.js";
 export type { VoiceToTextResponse } from "./apis/media/voiceToText.js";
 export type { Voice2TextEvent, Voice2TextEventData } from "./apis/listen.js";
+export type { AddUserGroupCallOptions, AddUserGroupCallResponse } from "./apis/call/addUserGroupCall.js";
+export type { AnswerAckVoiceCallOptions, AnswerAckVoiceCallResponse } from "./apis/call/answerAckVoiceCall.js";
+export type { AnswerGroupCallOptions, AnswerGroupCallResponse } from "./apis/call/answerGroupCall.js";
+export type { AnswerVoiceCallOptions, AnswerVoiceCallResponse } from "./apis/call/answerVoiceCall.js";
+export type { BroadcastGroupCallStateOptions, BroadcastGroupCallStateResponse } from "./apis/call/broadcastGroupCallState.js";
+export type { CancelGroupCallOptions, CancelGroupCallResponse } from "./apis/call/cancelGroupCall.js";
+export type { EndGroupCallOptions, EndGroupCallResponse } from "./apis/call/endGroupCall.js";
+export type { FinishGroupCallOptions, FinishGroupCallResponse } from "./apis/call/finishGroupCall.js";
+export type { GetGroupCallStateResponse } from "./apis/call/getGroupCallState.js";
+export type { HoldVoiceCallOptions, HoldVoiceCallResponse } from "./apis/call/holdVoiceCall.js";
+export type { JoinGroupCallOptions, JoinGroupCallResponse } from "./apis/call/joinGroupCall.js";
+export type { LogEndVoiceCallOptions, LogEndVoiceCallResponse } from "./apis/call/logEndVoiceCall.js";
+export type { NotifyGroupCallOptions, NotifyGroupCallResponse } from "./apis/call/notifyGroupCall.js";
+export type { PingGroupCallOptions, PingGroupCallResponse } from "./apis/call/pingGroupCall.js";
+export type { RequestAudioToVideoCallOptions, RequestAudioToVideoCallResponse } from "./apis/call/requestAudioToVideoCall.js";
+export type { RequestGroupCallOptions, RequestGroupCallResponse } from "./apis/call/requestGroupCall.js";
+export type { RequestShareScreenCallOptions, RequestShareScreenCallResponse } from "./apis/call/requestShareScreenCall.js";
+export type { RequestVoiceCallOptions, RequestVoiceCallResponse } from "./apis/call/requestVoiceCall.js";
+export type { RingRingGroupCallOptions, RingRingGroupCallResponse } from "./apis/call/ringRingGroupCall.js";
+export type { RingRingVoiceCallOptions, RingRingVoiceCallResponse } from "./apis/call/ringRingVoiceCall.js";
+export type { SendRequestGroupCallOptions, SendRequestGroupCallResponse } from "./apis/call/sendRequestGroupCall.js";
+export type { SendRequestVoiceCallOptions, SendRequestVoiceCallResponse } from "./apis/call/sendRequestVoiceCall.js";
+export type { ShareScreenGroupCallOptions, ShareScreenGroupCallResponse } from "./apis/call/shareScreenGroupCall.js";
+export type { UnholdVoiceCallOptions, UnholdVoiceCallResponse } from "./apis/call/unholdVoiceCall.js";
+export type { UpdateCallMediaStateOptions, UpdateCallMediaStateResponse } from "./apis/call/updateCallMediaState.js";
 export { CloseReason } from "./apis/listen.js";
 export { LoginQRCallbackEventType } from "./apis/loginQR.js";
 export { FriendRecommendationsType } from "./apis/friend/getFriendRecommendations.js";
@@ -225,4 +267,5 @@ 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 { DEFAULT_ZALOCALL_IPC_KEY_BASE64, DEFAULT_ZALO_AUDIO_CODEC, DEFAULT_ZALO_VIDEO_CODEC, ZRTCMediaSubCommand, ZRTPControlCommand, ZRTPForwardSubCommand, ZRTPLegacyMediaType, ZRTCRole, ZaloCallController, ZaloCallTransport, ZaloRtcSession, ZaloSrtpSession, buildEchoRequest, buildEndCallRequest, buildInitCallRequest, buildInitCallResponse, buildPingRequest, buildPingResponse, buildRelayPingRequest, buildRequestForwardPacket, buildRtpPacket, buildZrtcExtendData, deriveSrtpSessionKey, generateSrtpMasterKeyBase64, parseIncomingCallEvent, parseRtpPacket, parseZRTPPacket, uidToUint32, wrapLegacyMediaPacket, wrapZrtcMediaPacket, type AcceptIncomingCallOptions, type BuildRtpPacketOptions, type IncomingAudioFrameEvent, type IncomingRtcpEvent, type IncomingRtpEvent, type IncomingVideoAnnexBFrameEvent, type IncomingVideoFrameEvent, type JoinGroupCallSessionOptions, type MakeDesktopCallOptions, type MakeDesktopGroupCallOptions, type ParsedIncomingCallInfo, type ParsedRtpPacket, type ParsedZRTPPacket, type RejectIncomingCallOptions, type SrtpCryptoSuite, type StartGroupCallOptions, type StartOutgoingCallOptions, type ZRTCMultiplexedMediaPacket, type ZRTCP2PPacket, type ZRTPControlPacket, type ZRTPEchoRequestOptions, type ZRTPEndCallRequestOptions, type ZRTPInitCallRequestOptions, type ZRTPInitCallResponseOptions, type ZRTPLegacyMediaPacket, type ZRTPPingRequestOptions, type ZRTPRawPacket, type ZRTPRelayPingRequestOptions, type ZRTPRequestForwardOptions, type ZaloCallConnectionParams, type ZaloCallControllerEvents, type ZaloCallControllerOptions, type ZaloCallIpcMessage, type ZaloCallMediaStateEvent, type ZaloCallSignalPayload, type ZaloCallTransportEvents, type ZaloCallTransportOptions, type ZaloMobileDirectHandoffBundle, type ZaloRtcSessionEvents, type ZaloRtcSessionOptions, type ZaloRtcSessionState, type ZrtcExtendDataOptions, } from "./call-engine/index.js";
 export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, preParseJsonIds, type ZdbTocEntry, } from "./utils.js";

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./models/index.js";
 export * from "./constants/index.js";
 export * from "./crypto/index.js";
 export * from "./core/index.js";
+export * from "./realtime/index.js";
 export * from "./zalo.js";
 // Others (Enum)
 export { CloseReason } from "./apis/listen.js";
@@ -16,4 +17,5 @@ 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 { DEFAULT_ZALOCALL_IPC_KEY_BASE64, DEFAULT_ZALO_AUDIO_CODEC, DEFAULT_ZALO_VIDEO_CODEC, ZRTCMediaSubCommand, ZRTPControlCommand, ZRTPForwardSubCommand, ZRTPLegacyMediaType, ZRTCRole, ZaloCallController, ZaloCallTransport, ZaloRtcSession, ZaloSrtpSession, buildEchoRequest, buildEndCallRequest, buildInitCallRequest, buildInitCallResponse, buildPingRequest, buildPingResponse, buildRelayPingRequest, buildRequestForwardPacket, buildRtpPacket, buildZrtcExtendData, deriveSrtpSessionKey, generateSrtpMasterKeyBase64, parseIncomingCallEvent, parseRtpPacket, parseZRTPPacket, uidToUint32, wrapLegacyMediaPacket, wrapZrtcMediaPacket, } from "./call-engine/index.js";
 export { generateRSAKeyPair, decryptWithPrivateKey, deriveZdbAesKey, decryptZdbBuffer, parseZdbHeader, encryptZCloudAES, decryptZCloudAES, preParseJsonIds, } from "./utils.js";

package/dist/models/CallEvent.d.ts

@@ -1,11 +1,24 @@
 export declare enum CallEventType {
     REQUEST = "request",
     ANSWER = "answer",
+    ANSWER_ACK = "answer_ack",
     CANCEL = "cancel",
     END = "end",
     RINGRING = "ringring",
+    ONOFF_CAMERA = "onoff_camera",
+    MUTE_AUDIO = "mute_audio",
+    AUDIO_TO_VIDEO = "audio_to_video",
+    SHARE_SCREEN = "share_screen",
     GROUP_REQUEST = "group_request",
+    GROUP_RINGRING = "group_ring_ring",
     GROUP_ANSWER = "group_answer",
+    GROUP_ANSWER_ACK = "group_answer_ack",
+    GROUP_CANCEL = "group_cancel",
+    GROUP_END = "group_end_call",
+    GROUP_ADD_USER = "group_add_user",
+    GROUP_NOTIFY = "group_notify",
+    GROUP_BROADCAST = "group_broadcast",
+    GROUP_BROADCAST_CONFIG = "group_broadcast_config",
     UNKNOWN = "unknown"
 }
 export type TCallEventData = {
@@ -18,6 +31,8 @@ export type TCallEventData = {
     sessId?: string;
     status?: number;
     callType?: number;
+    codec?: string;
+    params?: string | Record<string, unknown>;
     ts?: number | string;
     [key: string]: unknown;
 };

package/dist/models/CallEvent.js

@@ -2,11 +2,24 @@ export var CallEventType;
 (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";
 })(CallEventType || (CallEventType = {}));
 export function initializeCallEvent(data, act, act_type) {
@@ -18,30 +31,111 @@ export function initializeCallEvent(data, act, act_type) {
         case "answer":
             type = CallEventType.ANSWER;
             break;
+        case "answer_ack":
+        case "answerack":
+            type = CallEventType.ANSWER_ACK;
+            break;
         case "cancel":
             type = CallEventType.CANCEL;
             break;
         case "end":
         case "endcall":
+        case "end_call":
             type = CallEventType.END;
             break;
         case "ringring":
+        case "ring_ring":
             type = CallEventType.RINGRING;
             break;
+        case "onoff_camera":
+            type = CallEventType.ONOFF_CAMERA;
+            break;
+        case "mute_audio":
+            type = CallEventType.MUTE_AUDIO;
+            break;
+        case "audio_to_video":
+            type = CallEventType.AUDIO_TO_VIDEO;
+            break;
+        case "share_screen":
+            type = CallEventType.SHARE_SCREEN;
+            break;
         case "group_request":
             type = CallEventType.GROUP_REQUEST;
             break;
+        case "group_ring_ring":
+        case "group_ringring":
+            type = CallEventType.GROUP_RINGRING;
+            break;
         case "group_answer":
             type = CallEventType.GROUP_ANSWER;
             break;
+        case "group_answer_ack":
+            type = CallEventType.GROUP_ANSWER_ACK;
+            break;
+        case "group_cancel":
+            type = CallEventType.GROUP_CANCEL;
+            break;
+        case "group_end_call":
+        case "group_endcall":
+        case "group_end":
+            type = CallEventType.GROUP_END;
+            break;
+        case "group_add_user":
+            type = CallEventType.GROUP_ADD_USER;
+            break;
+        case "group_notify":
+            type = CallEventType.GROUP_NOTIFY;
+            break;
+        case "group_broadcast":
+            type = CallEventType.GROUP_BROADCAST;
+            break;
+        case "group_broadcast_config":
+            type = CallEventType.GROUP_BROADCAST_CONFIG;
+            break;
         default:
             type = 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/realtime/handlers/control.handler.js

@@ -4,10 +4,15 @@ import { initializeGroupEvent } from "../../models/GroupEvent.js";
 import { initializeSyncEvent } from "../../models/SyncEvent.js";
 import { decodeEventData, getFriendEventType, getGroupEventType } from "../../utils.js";
 export async function handleRealtimeControlPacket(listener, ctx, selfListen, version, cmd, subCmd, parsed, cipherKey) {
-    if (version == 1 && cmd == 601 && subCmd == 0) {
-        const parsedData = (await decodeEventData(parsed, cipherKey)).data;
-        const { controls } = parsedData;
+    if (version == 1 && (cmd == 601 || cmd == 603 || cmd == 604) && subCmd == 0) {
+        const decoded = await 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,
@@ -58,6 +63,15 @@ export async function handleRealtimeControlPacket(listener, ctx, selfListen, ver
                 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 = initializeCallEvent(callEventData, control.content.act, control.content.act_type);
                 listener.emit("call_event", callEvent);
             }

package/dist/realtime/listener.d.ts

@@ -21,6 +21,7 @@ export declare class Listener extends EventEmitter<ListenerEvents> {
     private retryTimeout?;
     private watchdogTimeout?;
     private consecutive1006Count;
+    private isManualStop;
     private id;
     constructor(ctx: ContextSession, urls: string[]);
     /**
@@ -65,5 +66,10 @@ export declare class Listener extends EventEmitter<ListenerEvents> {
      * @param lastMsgId Optional cursor message ID
      */
     requestOldReactions(threadType: ThreadType, lastMsgId?: string | null): void;
+    /**
+     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL và `cmd 604` CTRL_PULL_VOIP).
+     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông ngay cả khi vừa mở kết nối WebSocket.
+     */
+    requestOfflineVoipControls(): void;
     private reset;
 }

package/dist/realtime/listener.js

@@ -27,6 +27,7 @@ export class Listener extends EventEmitter {
     retryTimeout;
     watchdogTimeout;
     consecutive1006Count = 0;
+    isManualStop = false;
     id = 0;
     constructor(ctx, urls) {
         super();
@@ -152,6 +153,7 @@ export class Listener extends EventEmitter {
         logger(this.ctx).verbose(`Rotating endpoint to ${this.wsURL}`);
     }
     start({ retryOnClose = false } = {}) {
+        this.isManualStop = false;
         if (this.retryTimeout) {
             clearTimeout(this.retryTimeout);
             this.retryTimeout = undefined;
@@ -175,6 +177,10 @@ export class Listener extends EventEmitter {
             t: Date.now(),
         });
         const cookie = this.ctx.cookie.getCookieStringSync(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": getBrowserLanguage(this.ctx.language),
@@ -189,7 +195,7 @@ export class Listener extends EventEmitter {
                 "user-agent": this.userAgent,
                 cookie,
             },
-            agent: this.ctx.options.agent,
+            ...(wsAgent ? { agent: wsAgent } : {}),
         });
         this.ws = ws;
         ws.onopen = () => {
@@ -202,7 +208,8 @@ export 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) {
@@ -246,6 +253,7 @@ export class Listener extends EventEmitter {
                 if (version == 1 && cmd == 1 && subCmd == 1 && hasOwn(parsed, "key")) {
                     this.cipherKey = parsed.key;
                     this.emit("cipher_key", this.cipherKey);
+                    this.requestOfflineVoipControls();
                     if (this.pingInterval)
                         clearInterval(this.pingInterval);
                     const ping = () => {
@@ -288,19 +296,24 @@ export 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(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));
@@ -346,6 +359,24 @@ export 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/update.js

@@ -6,6 +6,9 @@ const NPM_REGISTRY = ZALO_DOMAINS.NPM_REGISTRY;
 export 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 = {
         ...(isBun
             ? {
@@ -13,7 +16,13 @@ export 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/utils.d.ts

@@ -112,13 +112,6 @@ 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

@@ -9,7 +9,7 @@ import { ZaloApiError, ZaloApiMissingImageMetadataGetter } from "./Errors/index.
 import { FriendEventType } from "./models/FriendEvent.js";
 import { GroupEventType } from "./models/GroupEvent.js";
 import { ZALO_DEFAULTS, ZALO_DOMAINS, ZALO_PROTOCOL } from "./constants/index.js";
-import { decodeAES, encodeAES } from "./crypto/index.js";
+import { decodeAES, encodeAES, preParseJsonIds } from "./crypto/index.js";
 export * from "./constants/index.js";
 export * from "./crypto/index.js";
 export * from "./core/index.js";
@@ -161,8 +161,20 @@ export 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
@@ -170,8 +182,8 @@ export 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);
@@ -447,67 +459,6 @@ 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,

package/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./dist";
+export * from "./dist/index.js";
 export as namespace Zalo;