@softtynet/zca-js 2.3.4 → 2.3.5

package/dist/apis.js

@@ -6,10 +6,16 @@ import { addPollOptionsFactory } from "./apis/board/addPollOptions.js";
 import { addQuickMessageFactory } from "./apis/business/addQuickMessage.js";
 import { addReactionFactory } from "./apis/chat/addReaction.js";
 import { addUnreadMarkFactory } from "./apis/chat/addUnreadMark.js";
+import { addUserGroupCallFactory } from "./apis/call/addUserGroupCall.js";
 import { addUserToGroupFactory } from "./apis/group/addUserToGroup.js";
 import { analyseGroupFactory } from "./apis/group/analyseGroup.js";
+import { answerAckVoiceCallFactory } from "./apis/call/answerAckVoiceCall.js";
+import { answerGroupCallFactory } from "./apis/call/answerGroupCall.js";
+import { answerVoiceCallFactory } from "./apis/call/answerVoiceCall.js";
 import { blockUserFactory } from "./apis/friend/blockUser.js";
 import { blockViewFeedFactory } from "./apis/friend/blockViewFeed.js";
+import { broadcastGroupCallStateFactory } from "./apis/call/broadcastGroupCallState.js";
+import { cancelGroupCallFactory } from "./apis/call/cancelGroupCall.js";
 import { cancelPullMobileFactory } from "./apis/sync/cancelPullMobile.js";
 import { cancelVoiceCallFactory } from "./apis/call/cancelVoiceCall.js";
 import { changeAccountAvatarFactory } from "./apis/profile/changeAccountAvatar.js";
@@ -22,11 +28,13 @@ import { clearUnreadFriendRequestsFactory } from "./apis/friend/clearUnreadFrien
 import { createAutoReplyFactory } from "./apis/business/createAutoReply.js";
 import { createBankAccountFactory } from "./apis/business/createBankAccount.js";
 import { createCatalogFactory } from "./apis/business/createCatalog.js";
+import { createControllerFactory } from "./apis/call/createController.js";
 import { createGroupFactory } from "./apis/group/createGroup.js";
 import { createNoteFactory } from "./apis/board/createNote.js";
 import { createPollFactory } from "./apis/board/createPoll.js";
 import { createProductCatalogFactory } from "./apis/business/createProductCatalog.js";
 import { createReminderFactory } from "./apis/board/createReminder.js";
+import { createRtcSessionFactory } from "./apis/call/createRtcSession.js";
 import { decryptGidsFactory } from "./apis/auth/decryptGids.js";
 import { deleteAutoReplyFactory } from "./apis/business/deleteAutoReply.js";
 import { deleteAvatarFactory } from "./apis/profile/deleteAvatar.js";
@@ -43,11 +51,13 @@ import { editNoteFactory } from "./apis/board/editNote.js";
 import { editReminderFactory } from "./apis/board/editReminder.js";
 import { enableGroupLinkFactory } from "./apis/group/enableGroupLink.js";
 import { encryptGidsFactory } from "./apis/auth/encryptGids.js";
+import { endGroupCallFactory } from "./apis/call/endGroupCall.js";
 import { endVoiceCallFactory } from "./apis/call/endVoiceCall.js";
 import { exportSessionFactory } from "./apis/auth/exportSession.js";
 import { fetchAccountInfoFactory } from "./apis/profile/fetchAccountInfo.js";
 import { findUserFactory } from "./apis/friend/findUser.js";
 import { findUserByUsernameFactory } from "./apis/friend/findUserByUsername.js";
+import { finishGroupCallFactory } from "./apis/call/finishGroupCall.js";
 import { forwardMessageFactory } from "./apis/chat/forwardMessage.js";
 import { getAliasListFactory } from "./apis/friend/getAliasList.js";
 import { getAliasListV2Factory } from "./apis/friend/getAliasListV2.js";
@@ -85,6 +95,7 @@ import { getFriendsActivePCWebFactory } from "./apis/friend/getFriendsActivePCWe
 import { getFriendsEmojiStatusFactory } from "./apis/friend/getFriendsEmojiStatus.js";
 import { getFullAvatarFactory } from "./apis/profile/getFullAvatar.js";
 import { getGroupBlockedMemberFactory } from "./apis/group/getGroupBlockedMember.js";
+import { getGroupCallStateFactory } from "./apis/call/getGroupCallState.js";
 import { getGroupChatHistoryFactory } from "./apis/group/getGroupChatHistory.js";
 import { getGroupCloudMessageJumpFactory } from "./apis/group/getGroupCloudMessageJump.js";
 import { getGroupCloudMessagePathFactory } from "./apis/group/getGroupCloudMessagePath.js";
@@ -149,15 +160,20 @@ import { getUnreadMarkFactory } from "./apis/chat/getUnreadMark.js";
 import { getUsageMyCloudFactory } from "./apis/zcloud/getUsageMyCloud.js";
 import { getUsageZCloudFactory } from "./apis/zcloud/getUsageZCloud.js";
 import { getUserInfoFactory } from "./apis/profile/getUserInfo.js";
+import { holdVoiceCallFactory } from "./apis/call/holdVoiceCall.js";
 import { inviteUserToGroupsFactory } from "./apis/group/inviteUserToGroups.js";
+import { joinGroupCallFactory } from "./apis/call/joinGroupCall.js";
 import { joinGroupInviteBoxFactory } from "./apis/group/joinGroupInviteBox.js";
 import { joinGroupLinkFactory } from "./apis/group/joinGroupLink.js";
 import { keepAliveFactory } from "./apis/auth/keepAlive.js";
 import { lastOnlineFactory } from "./apis/friend/lastOnline.js";
 import { leaveGroupFactory } from "./apis/group/leaveGroup.js";
 import { lockPollFactory } from "./apis/board/lockPoll.js";
+import { logEndVoiceCallFactory } from "./apis/call/logEndVoiceCall.js";
 import { lostFocusFactory } from "./apis/auth/lostFocus.js";
+import { notifyGroupCallFactory } from "./apis/call/notifyGroupCall.js";
 import { parseLinkFactory } from "./apis/chat/parseLink.js";
+import { pingGroupCallFactory } from "./apis/call/pingGroupCall.js";
 import { preloadConversationsFactory } from "./apis/chat/preloadConversations.js";
 import { pullMobileFactory } from "./apis/sync/pullMobile.js";
 import { readContactTabFactory } from "./apis/friend/readContactTab.js";
@@ -173,10 +189,16 @@ import { removeQuickMessageFactory } from "./apis/business/removeQuickMessage.js
 import { removeReminderFactory } from "./apis/board/removeReminder.js";
 import { removeUnreadMarkFactory } from "./apis/chat/removeUnreadMark.js";
 import { removeUserFromGroupFactory } from "./apis/group/removeUserFromGroup.js";
+import { requestAudioToVideoCallFactory } from "./apis/call/requestAudioToVideoCall.js";
+import { requestGroupCallFactory } from "./apis/call/requestGroupCall.js";
+import { requestShareScreenCallFactory } from "./apis/call/requestShareScreenCall.js";
 import { requestSyncFromPhoneFactory } from "./apis/sync/requestSyncFromPhone.js";
+import { requestVoiceCallFactory } from "./apis/call/requestVoiceCall.js";
 import { resetHiddenConversPinFactory } from "./apis/chat/resetHiddenConversPin.js";
 import { reuseAvatarFactory } from "./apis/profile/reuseAvatar.js";
 import { reviewPendingMemberRequestFactory } from "./apis/group/reviewPendingMemberRequest.js";
+import { ringRingGroupCallFactory } from "./apis/call/ringRingGroupCall.js";
+import { ringRingVoiceCallFactory } from "./apis/call/ringRingVoiceCall.js";
 import { scanURLFactory } from "./apis/auth/scanURL.js";
 import { searchStickerFactory } from "./apis/sticker/searchSticker.js";
 import { sendBankCardFactory } from "./apis/chat/sendBankCard.js";
@@ -186,6 +208,8 @@ import { sendFriendRequestFactory } from "./apis/friend/sendFriendRequest.js";
 import { sendLinkFactory } from "./apis/chat/sendLink.js";
 import { sendMessageFactory } from "./apis/chat/sendMessage.js";
 import { sendReportFactory } from "./apis/chat/sendReport.js";
+import { sendRequestGroupCallFactory } from "./apis/call/sendRequestGroupCall.js";
+import { sendRequestVoiceCallFactory } from "./apis/call/sendRequestVoiceCall.js";
 import { sendSeenEventFactory } from "./apis/chat/sendSeenEvent.js";
 import { sendStickerFactory } from "./apis/chat/sendSticker.js";
 import { sendTypingEventFactory } from "./apis/chat/sendTypingEvent.js";
@@ -196,15 +220,18 @@ import { setHiddenConversationsFactory } from "./apis/chat/setHiddenConversation
 import { setMuteFactory } from "./apis/chat/setMute.js";
 import { setPinnedConversationsFactory } from "./apis/chat/setPinnedConversations.js";
 import { sharePollFactory } from "./apis/board/sharePoll.js";
+import { shareScreenGroupCallFactory } from "./apis/call/shareScreenGroupCall.js";
 import { unblockUserFactory } from "./apis/friend/unblockUser.js";
 import { undoFactory } from "./apis/chat/undo.js";
 import { undoFriendRequestFactory } from "./apis/friend/undoFriendRequest.js";
 import { undoMultiMessageFactory } from "./apis/chat/undoMultiMessage.js";
+import { unholdVoiceCallFactory } from "./apis/call/unholdVoiceCall.js";
 import { updateActiveStatusFactory } from "./apis/auth/updateActiveStatus.js";
 import { updateArchivedChatListFactory } from "./apis/chat/updateArchivedChatList.js";
 import { updateAutoDeleteChatFactory } from "./apis/chat/updateAutoDeleteChat.js";
 import { updateAutoReplyFactory } from "./apis/business/updateAutoReply.js";
 import { updateBankAccountFactory } from "./apis/business/updateBankAccount.js";
+import { updateCallMediaStateFactory } from "./apis/call/updateCallMediaState.js";
 import { updateCatalogFactory } from "./apis/business/updateCatalog.js";
 import { updateGroupSettingsFactory } from "./apis/group/updateGroupSettings.js";
 import { updateHiddenConversPinFactory } from "./apis/chat/updateHiddenConversPin.js";
@@ -324,9 +351,36 @@ export class API {
     get call() {
         if (!this._domains.call) {
             const createNamespace = (api) => ({
+                get addUserGroupCall() { return api.addUserGroupCall; },
+                get answerAckVoiceCall() { return api.answerAckVoiceCall; },
+                get answerGroupCall() { return api.answerGroupCall; },
+                get answerVoiceCall() { return api.answerVoiceCall; },
+                get broadcastGroupCallState() { return api.broadcastGroupCallState; },
+                get cancelGroupCall() { return api.cancelGroupCall; },
                 get cancelVoiceCall() { return api.cancelVoiceCall; },
+                get createController() { return api.createController; },
+                get createRtcSession() { return api.createRtcSession; },
+                get endGroupCall() { return api.endGroupCall; },
                 get endVoiceCall() { return api.endVoiceCall; },
+                get finishGroupCall() { return api.finishGroupCall; },
+                get getGroupCallState() { return api.getGroupCallState; },
+                get holdVoiceCall() { return api.holdVoiceCall; },
+                get joinGroupCall() { return api.joinGroupCall; },
+                get logEndVoiceCall() { return api.logEndVoiceCall; },
+                get notifyGroupCall() { return api.notifyGroupCall; },
+                get pingGroupCall() { return api.pingGroupCall; },
+                get requestAudioToVideoCall() { return api.requestAudioToVideoCall; },
+                get requestGroupCall() { return api.requestGroupCall; },
+                get requestShareScreenCall() { return api.requestShareScreenCall; },
+                get requestVoiceCall() { return api.requestVoiceCall; },
+                get ringRingGroupCall() { return api.ringRingGroupCall; },
+                get ringRingVoiceCall() { return api.ringRingVoiceCall; },
+                get sendRequestGroupCall() { return api.sendRequestGroupCall; },
+                get sendRequestVoiceCall() { return api.sendRequestVoiceCall; },
                 get sendVoiceCall() { return api.sendVoiceCall; },
+                get shareScreenGroupCall() { return api.shareScreenGroupCall; },
+                get unholdVoiceCall() { return api.unholdVoiceCall; },
+                get updateCallMediaState() { return api.updateCallMediaState; },
             });
             this._domains.call = createNamespace(this);
         }
@@ -586,18 +640,36 @@ export class API {
     get addUnreadMark() {
         return (this._cache.addUnreadMark ??= addUnreadMarkFactory(this.ctx, this));
     }
+    get addUserGroupCall() {
+        return (this._cache.addUserGroupCall ??= addUserGroupCallFactory(this.ctx, this));
+    }
     get addUserToGroup() {
         return (this._cache.addUserToGroup ??= addUserToGroupFactory(this.ctx, this));
     }
     get analyseGroup() {
         return (this._cache.analyseGroup ??= analyseGroupFactory(this.ctx, this));
     }
+    get answerAckVoiceCall() {
+        return (this._cache.answerAckVoiceCall ??= answerAckVoiceCallFactory(this.ctx, this));
+    }
+    get answerGroupCall() {
+        return (this._cache.answerGroupCall ??= answerGroupCallFactory(this.ctx, this));
+    }
+    get answerVoiceCall() {
+        return (this._cache.answerVoiceCall ??= answerVoiceCallFactory(this.ctx, this));
+    }
     get blockUser() {
         return (this._cache.blockUser ??= blockUserFactory(this.ctx, this));
     }
     get blockViewFeed() {
         return (this._cache.blockViewFeed ??= blockViewFeedFactory(this.ctx, this));
     }
+    get broadcastGroupCallState() {
+        return (this._cache.broadcastGroupCallState ??= broadcastGroupCallStateFactory(this.ctx, this));
+    }
+    get cancelGroupCall() {
+        return (this._cache.cancelGroupCall ??= cancelGroupCallFactory(this.ctx, this));
+    }
     get cancelPullMobile() {
         return (this._cache.cancelPullMobile ??= cancelPullMobileFactory(this.ctx, this));
     }
@@ -634,6 +706,9 @@ export class API {
     get createCatalog() {
         return (this._cache.createCatalog ??= createCatalogFactory(this.ctx, this));
     }
+    get createController() {
+        return (this._cache.createController ??= createControllerFactory(this.ctx, this));
+    }
     get createGroup() {
         return (this._cache.createGroup ??= createGroupFactory(this.ctx, this));
     }
@@ -649,6 +724,9 @@ export class API {
     get createReminder() {
         return (this._cache.createReminder ??= createReminderFactory(this.ctx, this));
     }
+    get createRtcSession() {
+        return (this._cache.createRtcSession ??= createRtcSessionFactory(this.ctx, this));
+    }
     get decryptGids() {
         return (this._cache.decryptGids ??= decryptGidsFactory(this.ctx, this));
     }
@@ -697,6 +775,9 @@ export class API {
     get encryptGids() {
         return (this._cache.encryptGids ??= encryptGidsFactory(this.ctx, this));
     }
+    get endGroupCall() {
+        return (this._cache.endGroupCall ??= endGroupCallFactory(this.ctx, this));
+    }
     get endVoiceCall() {
         return (this._cache.endVoiceCall ??= endVoiceCallFactory(this.ctx, this));
     }
@@ -712,6 +793,9 @@ export class API {
     get findUserByUsername() {
         return (this._cache.findUserByUsername ??= findUserByUsernameFactory(this.ctx, this));
     }
+    get finishGroupCall() {
+        return (this._cache.finishGroupCall ??= finishGroupCallFactory(this.ctx, this));
+    }
     get forwardMessage() {
         return (this._cache.forwardMessage ??= forwardMessageFactory(this.ctx, this));
     }
@@ -823,6 +907,9 @@ export class API {
     get getGroupBlockedMember() {
         return (this._cache.getGroupBlockedMember ??= getGroupBlockedMemberFactory(this.ctx, this));
     }
+    get getGroupCallState() {
+        return (this._cache.getGroupCallState ??= getGroupCallStateFactory(this.ctx, this));
+    }
     get getGroupChatHistory() {
         return (this._cache.getGroupChatHistory ??= getGroupChatHistoryFactory(this.ctx, this));
     }
@@ -1015,9 +1102,15 @@ export class API {
     get getUserInfo() {
         return (this._cache.getUserInfo ??= getUserInfoFactory(this.ctx, this));
     }
+    get holdVoiceCall() {
+        return (this._cache.holdVoiceCall ??= holdVoiceCallFactory(this.ctx, this));
+    }
     get inviteUserToGroups() {
         return (this._cache.inviteUserToGroups ??= inviteUserToGroupsFactory(this.ctx, this));
     }
+    get joinGroupCall() {
+        return (this._cache.joinGroupCall ??= joinGroupCallFactory(this.ctx, this));
+    }
     get joinGroupInviteBox() {
         return (this._cache.joinGroupInviteBox ??= joinGroupInviteBoxFactory(this.ctx, this));
     }
@@ -1036,12 +1129,21 @@ export class API {
     get lockPoll() {
         return (this._cache.lockPoll ??= lockPollFactory(this.ctx, this));
     }
+    get logEndVoiceCall() {
+        return (this._cache.logEndVoiceCall ??= logEndVoiceCallFactory(this.ctx, this));
+    }
     get lostFocus() {
         return (this._cache.lostFocus ??= lostFocusFactory(this.ctx, this));
     }
+    get notifyGroupCall() {
+        return (this._cache.notifyGroupCall ??= notifyGroupCallFactory(this.ctx, this));
+    }
     get parseLink() {
         return (this._cache.parseLink ??= parseLinkFactory(this.ctx, this));
     }
+    get pingGroupCall() {
+        return (this._cache.pingGroupCall ??= pingGroupCallFactory(this.ctx, this));
+    }
     get preloadConversations() {
         return (this._cache.preloadConversations ??= preloadConversationsFactory(this.ctx, this));
     }
@@ -1087,9 +1189,21 @@ export class API {
     get removeUserFromGroup() {
         return (this._cache.removeUserFromGroup ??= removeUserFromGroupFactory(this.ctx, this));
     }
+    get requestAudioToVideoCall() {
+        return (this._cache.requestAudioToVideoCall ??= requestAudioToVideoCallFactory(this.ctx, this));
+    }
+    get requestGroupCall() {
+        return (this._cache.requestGroupCall ??= requestGroupCallFactory(this.ctx, this));
+    }
+    get requestShareScreenCall() {
+        return (this._cache.requestShareScreenCall ??= requestShareScreenCallFactory(this.ctx, this));
+    }
     get requestSyncFromPhone() {
         return (this._cache.requestSyncFromPhone ??= requestSyncFromPhoneFactory(this.ctx, this));
     }
+    get requestVoiceCall() {
+        return (this._cache.requestVoiceCall ??= requestVoiceCallFactory(this.ctx, this));
+    }
     get resetHiddenConversPin() {
         return (this._cache.resetHiddenConversPin ??= resetHiddenConversPinFactory(this.ctx, this));
     }
@@ -1099,6 +1213,12 @@ export class API {
     get reviewPendingMemberRequest() {
         return (this._cache.reviewPendingMemberRequest ??= reviewPendingMemberRequestFactory(this.ctx, this));
     }
+    get ringRingGroupCall() {
+        return (this._cache.ringRingGroupCall ??= ringRingGroupCallFactory(this.ctx, this));
+    }
+    get ringRingVoiceCall() {
+        return (this._cache.ringRingVoiceCall ??= ringRingVoiceCallFactory(this.ctx, this));
+    }
     get scanURL() {
         return (this._cache.scanURL ??= scanURLFactory(this.ctx, this));
     }
@@ -1126,6 +1246,12 @@ export class API {
     get sendReport() {
         return (this._cache.sendReport ??= sendReportFactory(this.ctx, this));
     }
+    get sendRequestGroupCall() {
+        return (this._cache.sendRequestGroupCall ??= sendRequestGroupCallFactory(this.ctx, this));
+    }
+    get sendRequestVoiceCall() {
+        return (this._cache.sendRequestVoiceCall ??= sendRequestVoiceCallFactory(this.ctx, this));
+    }
     get sendSeenEvent() {
         return (this._cache.sendSeenEvent ??= sendSeenEventFactory(this.ctx, this));
     }
@@ -1156,6 +1282,9 @@ export class API {
     get sharePoll() {
         return (this._cache.sharePoll ??= sharePollFactory(this.ctx, this));
     }
+    get shareScreenGroupCall() {
+        return (this._cache.shareScreenGroupCall ??= shareScreenGroupCallFactory(this.ctx, this));
+    }
     get unblockUser() {
         return (this._cache.unblockUser ??= unblockUserFactory(this.ctx, this));
     }
@@ -1168,6 +1297,9 @@ export class API {
     get undoMultiMessage() {
         return (this._cache.undoMultiMessage ??= undoMultiMessageFactory(this.ctx, this));
     }
+    get unholdVoiceCall() {
+        return (this._cache.unholdVoiceCall ??= unholdVoiceCallFactory(this.ctx, this));
+    }
     get updateActiveStatus() {
         return (this._cache.updateActiveStatus ??= updateActiveStatusFactory(this.ctx, this));
     }
@@ -1183,6 +1315,9 @@ export class API {
     get updateBankAccount() {
         return (this._cache.updateBankAccount ??= updateBankAccountFactory(this.ctx, this));
     }
+    get updateCallMediaState() {
+        return (this._cache.updateCallMediaState ??= updateCallMediaStateFactory(this.ctx, this));
+    }
     get updateCatalog() {
         return (this._cache.updateCatalog ??= updateCatalogFactory(this.ctx, this));
     }

package/dist/call-engine/ZRTPPacketCodec.d.ts

@@ -0,0 +1,262 @@
+import { Buffer } from "node:buffer";
+/**
+ * Các mã lệnh điều khiển UDP trong `zrtc::ZRTPPacket` (`_buildPacketInternal` @ `0x10015830c`)
+ */
+export declare enum ZRTPControlCommand {
+    RelayPing = 2,
+    EndCall = 3,
+    Ping = 5,
+    InitCallCaller = 11,
+    InitCallCallee = 12,
+    RequestForward = 32,
+    InitZaviPing = 51
+}
+/**
+ * Sub-command cho gói tin điều khiển `RequestForward` (`cmd = 32` / `0x0020`, `byte[20]`)
+ * dùng để Ping/Pong kiểm tra kết nối 2 chiều qua máy chủ Relay và điều khiển Audio/Video.
+ */
+export declare enum ZRTPForwardSubCommand {
+    OnMic = 5,
+    OffMic = 6,
+    OnCamera = 7,
+    OffCamera = 8,
+    OffCameraCallKit = 9,
+    VideoControl = 10,
+    Ping = 11,
+    Pong = 16,
+    PartnerSuspendVideo = 17
+}
+/**
+ * Loại gói tin Media qua máy chủ Relay:
+ * - Gửi đi (5-byte header `[type(1B)] + [routingToken(4B LE)] + [RTP/RTCP]`): `{3, 5, 7, 13, 15}`
+ * - Nhận về từ Relay (1-byte header `[type(1B)] + [RTP]`): `{4, 7, 14}`
+ * - Nhận về RTCP từ Relay (5-byte header `[type(1B)] + [routingToken(4B LE)] + [RTCP]`): `{5, 15}`
+ */
+export declare enum ZRTPLegacyMediaType {
+    AudioRtp = 3,
+    IncomingAudioRtp = 4,
+    AudioRtcp = 5,
+    AudioFec = 7,
+    VideoRtp = 13,
+    IncomingVideoRtp = 14,
+    VideoRtcp = 15
+}
+/**
+ * Sub-command cho gói tin ZRTC Multiplexed Media (`byte[0] == 0x7f`, 9-byte header)
+ */
+export declare enum ZRTCMediaSubCommand {
+    P2PPingRequest = 1,
+    P2PPingResponse = 2,
+    P2PInitCaller = 3,
+    P2PInitCallee = 4,
+    AudioRtp = 6,
+    AudioRtcp = 7,
+    VideoRtp = 8,
+    VideoRtcp = 9,
+    AudioFec = 10
+}
+export declare enum ZRTCRole {
+    Caller = 0,
+    Callee = 1
+}
+export type ZRTPInitCallRequestOptions = {
+    isCaller?: boolean;
+    seqNum?: number;
+    headerCallId?: number;
+    callId: number;
+    fromUid?: number;
+    toUid?: number;
+    flags?: number;
+    subFlags?: number;
+    sessId: string;
+    zrtcConfig?: string;
+};
+export type ZRTPInitCallResponseOptions = {
+    isCaller?: boolean;
+    seqNum?: number;
+    headerCallId?: number;
+    callId: number;
+    fromUid?: number;
+    toUid?: number;
+    flags?: number;
+    errorCode?: number;
+    routingToken: number;
+    sessId: string;
+};
+export type ZRTPPingRequestOptions = {
+    seqNum: number;
+    callId: number;
+    fromUid?: number;
+    toUid?: number;
+    elapsedMs: number | string;
+    minByteLength?: number;
+};
+export type ZRTPRelayPingRequestOptions = {
+    seqNum?: number;
+    callId?: number;
+    fromUid: number;
+    routingToken: number;
+    sessId: string;
+};
+export type ZRTPRequestForwardOptions = {
+    seqNum?: number;
+    seqId: number;
+    fromUid: number;
+    routingToken: number;
+    subCmd: ZRTPForwardSubCommand | number;
+    payload?: string | Buffer;
+};
+export type ZRTPEchoRequestOptions = {
+    seqNum: number;
+    callId: number;
+    fromUid?: number;
+    toUid?: number;
+    token: number;
+};
+export type ZRTPEndCallRequestOptions = {
+    seqNum?: number;
+    callId: number;
+    fromUid?: number;
+    toUid?: number;
+    routingToken?: number;
+    flags?: number;
+};
+export type ZRTPControlPacket = {
+    family: "control";
+    isResponse: boolean;
+    packetType: 1 | 2;
+    subType: number;
+    seqNum: number;
+    headerCallId: number;
+    fromUid: number;
+    toUid: number;
+    cmd: number;
+    flags: number;
+    callId?: number;
+    subFlags?: number;
+    errorCode?: number;
+    routingToken?: number;
+    sessId?: string;
+    zrtcConfig?: string;
+    pingString?: string;
+    forwardPayload?: Buffer;
+    echoToken?: number;
+    rawBody: Buffer;
+};
+export type ZRTPLegacyMediaPacket = {
+    family: "legacy_media";
+    mediaType: ZRTPLegacyMediaType;
+    isVideo: boolean;
+    isRtcp: boolean;
+    isFec: boolean;
+    routingId: number;
+    rtpPayload: Buffer;
+};
+export type ZRTCMultiplexedMediaPacket = {
+    family: "zrtc_media";
+    version: number;
+    role: ZRTCRole;
+    routingToken: number;
+    subCmd: ZRTCMediaSubCommand;
+    isVideo: boolean;
+    isRtcp: boolean;
+    isFec: boolean;
+    rtpPayload: Buffer;
+};
+export type ZRTCP2PPacket = {
+    family: "zrtc_p2p";
+    version: number;
+    role: ZRTCRole;
+    routingToken: number;
+    subCmd: number;
+    seqNum: number;
+    callId: number;
+    payload: Buffer;
+};
+export type ZRTPRawPacket = {
+    family: "raw";
+    raw: Buffer;
+};
+export type ParsedZRTPPacket = ZRTPControlPacket | ZRTPLegacyMediaPacket | ZRTCMultiplexedMediaPacket | ZRTCP2PPacket | ZRTPRawPacket;
+/**
+ * Chuỗi codec Opus chuẩn được `ZaloCall` tạo trong `sendSignal 416`
+ */
+export declare const DEFAULT_ZALO_AUDIO_CODEC: string;
+/**
+ * Chuỗi codec Audio + Video H264 chuẩn cho cuộc gọi Video
+ */
+export declare const DEFAULT_ZALO_VIDEO_CODEC: string;
+export type ZrtcExtendDataOptions = {
+    rtpAddress: string;
+    rtcpAddress: string;
+    isVideo?: boolean;
+    srtpMode?: number;
+    srtpKey?: string;
+    platform?: number;
+    packetMode?: number;
+};
+/**
+ * Tạo cấu trúc `extendData` chuẩn xác theo `ZaloCall` (`sendSignal 416` / `answer 402`).
+ */
+export declare function buildZrtcExtendData(options: ZrtcExtendDataOptions): Record<string, unknown>;
+/**
+ * Rút gọn UID 64-bit dạng chuỗi của Zalo về `uint32` dùng trong header `ZRTPPacket`
+ */
+export declare function uidToUint32(uid: string | number | undefined): number;
+/**
+ * Đóng gói gói tin UDP `InitCall` (`0x01 0x7e`, `cmd = 11` cho Caller hoặc `12` cho Callee)
+ * gửi tới máy chủ `rtpaddr` của Zalo (`zrtc::ZRTPPacket::_buildPacketInternal` @ `0x10015830c`).
+ */
+export declare function buildInitCallRequest(options: ZRTPInitCallRequestOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP phản hồi `InitCall` (`0x02 0x7e`, `cmd = 11 | 12`)
+ * khớp chính xác với `zrtc::ZRTPPacket::_parsePacketInternal` (`0x100158db8`)
+ * và `zrtc::CallController` (`0x100177920`).
+ */
+export declare function buildInitCallResponse(options: ZRTPInitCallResponseOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP `Ping` (`0x01 0x01`, `cmd = 5`) gửi định kỳ tới máy chủ relay của Zalo.
+ */
+export declare function buildPingRequest(options: ZRTPPingRequestOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP phản hồi `Ping` (`0x02 0x01`, `cmd = 5`).
+ */
+export declare function buildPingResponse(options: ZRTPPingRequestOptions & {
+    errorCode?: number;
+}): Buffer;
+/**
+ * Đóng gói gói tin UDP `RequestPing` (`0x01 0x01`, `cmd = 2`) gửi tới máy chủ Relay Zalo
+ * (`zrtc::ZRTPPacket::initZRTPPacketRequestPing` @ `0x100157b88`).
+ */
+export declare function buildRelayPingRequest(options: ZRTPRelayPingRequestOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP `RequestForward` (`0x01 0x01`, `cmd = 32` / `0x0020`)
+ * dùng cho Ping (`subCmd = 11`) / Pong (`subCmd = 16`) giữa 2 đầu qua máy chủ Relay
+ * (`zrtc::ZRTPPacket::initZRTPPacketRequestForward` @ `0x100157c4c`).
+ */
+export declare function buildRequestForwardPacket(options: ZRTPRequestForwardOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP `Echo` (`cmd = 3`)
+ */
+export declare function buildEchoRequest(options: ZRTPEchoRequestOptions): Buffer;
+/**
+ * Đóng gói gói tin UDP `RequestEndCall` (`0x01 0x7e`, `cmd = 3`, 25 bytes)
+ * khớp với `zrtc::ZRTPPacket::initZRTPPacketRequestEndCall` (`0x100157b44`)
+ * và `_buildPacketInternal` (`0x10015830c`).
+ */
+export declare function buildEndCallRequest(options: ZRTPEndCallRequestOptions): Buffer;
+/**
+ * Bọc gói tin chuẩn WebRTC RTP/RTCP/SRTP vào khung 5-byte Legacy Media của Zalo
+ * (`byte[0]` in `{3, 5, 7, 13, 15}` + `routingId` 4B LE).
+ */
+export declare function wrapLegacyMediaPacket(mediaType: ZRTPLegacyMediaType, routingId: number, rtpOrRtcpPayload: Buffer): Buffer;
+/**
+ * Bọc gói tin chuẩn WebRTC RTP/RTCP/SRTP vào khung 9-byte ZRTC Multiplexed Media (`0x7f`)
+ * (`[0x7f, 0x00, role, routingToken(4B LE), subCmd(2B LE)] + [RTP/RTCP]`).
+ */
+export declare function wrapZrtcMediaPacket(subCmd: ZRTCMediaSubCommand, routingToken: number, rtpOrRtcpPayload: Buffer, role?: ZRTCRole): Buffer;
+/**
+ * Giải mã bất kỳ gói tin UDP `ZRTPPacket` nào nhận được từ máy chủ Relay Zalo hoặc Peer
+ * (`zrtc::ZRTPPacket::_parsePacketInternal` @ `0x1001589e8`).
+ */
+export declare function parseZRTPPacket(buf: Buffer): ParsedZRTPPacket;