@softtynet/zca-js 2.3.4 → 2.3.6

package/dist/apis/call/sendRequestGroupCall.js

@@ -0,0 +1,48 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+import { CallType } from "./sendVoiceCall.js";
+export const sendRequestGroupCallFactory = apiFactory()((api, _ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Gửi tín hiệu mời tham gia / đổ chuông cuộc gọi nhóm (`/api/voicecall/group/request`, command `12434`).
+     *
+     * @param groupId ID của nhóm
+     * @param options Thông tin `callId`, `session`, `partners`, `callType` và `data`
+     * @throws {ZaloApiError}
+     */
+    return async function sendRequestGroupCall(groupId, options) {
+        if (!groupId)
+            throw new ZaloApiError("Missing groupId");
+        if (!options?.callId)
+            throw new ZaloApiError("Missing callId");
+        if (!options?.session)
+            throw new ZaloApiError("Missing session");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const dataStr = options.data === undefined
+            ? "{}"
+            : typeof options.data === "string"
+                ? options.data
+                : JSON.stringify(options.data);
+        const params = {
+            calleeId: options.calleeId ?? "",
+            callId: options.callId,
+            callType: options.callType ?? CallType.GroupAudio,
+            data: dataStr,
+            session: options.session,
+            partners: (options.partners ?? []).map(String),
+            groupId: String(groupId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt sendRequestGroupCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/group/request`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/call/sendRequestVoiceCall.d.ts

@@ -0,0 +1,11 @@
+export type SendRequestVoiceCallOptions = {
+    callId: number;
+    session: string;
+    rtpAddress: string;
+    rtcpAddress: string;
+    codec?: string;
+    extendData?: string | Record<string, unknown>;
+    subCommand?: number;
+};
+export type SendRequestVoiceCallResponse = Record<string, unknown>;
+export declare const sendRequestVoiceCallFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (calleeId: string, options: SendRequestVoiceCallOptions) => Promise<SendRequestVoiceCallResponse>;

package/dist/apis/call/sendRequestVoiceCall.js

@@ -0,0 +1,51 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const sendRequestVoiceCallFactory = apiFactory()((api, ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Gửi tín hiệu đổ chuông kèm thông tin kết nối RTP/RTCP & `extendData` (`/api/voicecall/request`, command `11301`, signal `416`).
+     *
+     * @param calleeId User ID của người nhận cuộc gọi
+     * @param options Thông tin `callId`, `session`, `rtpAddress`, `rtcpAddress`, `codec` và `extendData`
+     * @throws {ZaloApiError}
+     */
+    return async function sendRequestVoiceCall(calleeId, options) {
+        if (!calleeId)
+            throw new ZaloApiError("Missing calleeId");
+        if (!options?.callId)
+            throw new ZaloApiError("Missing callId");
+        if (!options?.session)
+            throw new ZaloApiError("Missing session");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const extendDataStr = options.extendData === undefined
+            ? undefined
+            : typeof options.extendData === "string"
+                ? options.extendData
+                : JSON.stringify(options.extendData);
+        const params = {
+            calleeId: String(calleeId),
+            rtcpAddress: options.rtcpAddress ?? "",
+            rtpAddress: options.rtpAddress ?? "",
+            codec: options.codec ?? "[]",
+            session: options.session,
+            callId: options.callId,
+            imei: ctx.imei,
+        };
+        if (extendDataStr) {
+            params.extendData = extendDataStr;
+            params.subCommand = options.subCommand ?? 3;
+        }
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt sendRequestVoiceCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/request`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/call/sendVoiceCall.d.ts

@@ -1,6 +1,8 @@
 export declare enum CallType {
     Audio = 1,
-    Video = 3
+    Video = 3,
+    GroupAudio = 5,
+    GroupVideo = 6
 }
 export type SendVoiceCallOptions = {
     callType?: CallType;
@@ -18,6 +20,9 @@ export type RequestCallServerEntry = {
 };
 export type RequestCallServerInfo = {
     sessId: string;
+    fromId?: number;
+    toId?: number;
+    protocol?: number;
     rtpServer?: string;
     rtcpServer?: string;
     rtpIP?: string;
@@ -26,6 +31,8 @@ export type RequestCallServerInfo = {
     rtcpIPv6?: string;
     servers?: RequestCallServerEntry[];
     zrtpKey?: string;
+    zrtc_config?: Record<string, unknown> | string;
+    settings?: Record<string, unknown>;
     expiredTime?: number;
     codec?: string;
     [key: string]: unknown;

package/dist/apis/call/sendVoiceCall.js

@@ -1,9 +1,12 @@
 import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { DEFAULT_ZALO_AUDIO_CODEC, buildZrtcExtendData } from "../../call-engine/ZRTPPacketCodec.js";
 import { apiFactory, resolveResponse } from "../../utils.js";
 export var CallType;
 (function (CallType) {
     CallType[CallType["Audio"] = 1] = "Audio";
     CallType[CallType["Video"] = 3] = "Video";
+    CallType[CallType["GroupAudio"] = 5] = "GroupAudio";
+    CallType[CallType["GroupVideo"] = 6] = "GroupVideo";
 })(CallType || (CallType = {}));
 function parseServerEndpoint(addr) {
     if (!addr)
@@ -32,7 +35,7 @@ export const sendVoiceCallFactory = apiFactory()((api, ctx, utils) => {
             throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
         const callType = options.callType ?? CallType.Audio;
         const callId = options.callId ?? Math.floor(Math.random() * 2_000_000_000);
-        const codec = options.codec ?? "[]";
+        const codec = options.codec ?? DEFAULT_ZALO_AUDIO_CODEC;
         const normalizedCalleeId = String(calleeId);
         // Step 1: Allocate call session & RTP/RTCP relay endpoints (/api/voicecall/requestcall, command 11300)
         const step1Params = {
@@ -61,16 +64,15 @@ export const sendVoiceCallFactory = apiFactory()((api, ctx, utils) => {
         const rtp = parseServerEndpoint(resolvedRtpServer);
         const rtcp = parseServerEndpoint(resolvedRtcpServer);
         const sessId = serverInfo?.sessId ?? `${normalizedCalleeId}_${callId}_401`;
-        const resolvedCodec = serverInfo?.codec ?? codec;
+        const resolvedCodec = serverInfo?.codec && serverInfo.codec !== "[]" ? serverInfo.codec : codec;
         // Step 2: Send ringing signaling request (/api/voicecall/request, command 11301)
         const isVideo = callType === CallType.Video;
         const extendData = JSON.stringify({
-            callType: isVideo ? 1 : 0,
-            video: {
-                codec: isVideo ? [{ name: "h264", payload: 97 }] : [],
-            },
-            newZrtc: 1,
-            platform: 5,
+            ...buildZrtcExtendData({
+                rtpAddress: rtp.host,
+                rtcpAddress: rtcp.host,
+                isVideo,
+            }),
             rtcpDiff: 0,
             rtcp: [{ ip: rtcp.ip, port: rtcp.port }],
             rtp: [{ ip: rtp.ip, port: rtp.port }],

package/dist/apis/call/shareScreenGroupCall.d.ts

@@ -0,0 +1,10 @@
+export type ShareScreenGroupCallOptions = {
+    userId?: string;
+    hostCall: string;
+    status?: number;
+    audioState?: number;
+    videoState?: number;
+    data?: string | Record<string, unknown>;
+};
+export type ShareScreenGroupCallResponse = Record<string, unknown>;
+export declare const shareScreenGroupCallFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (callId: number, options: ShareScreenGroupCallOptions) => Promise<ShareScreenGroupCallResponse>;

package/dist/apis/call/shareScreenGroupCall.js

@@ -0,0 +1,45 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const shareScreenGroupCallFactory = apiFactory()((api, ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Bật/tắt chia sẻ màn hình trong cuộc gọi nhóm (`/api/voicecall/group/sharescreen`, command `12044`).
+     *
+     * @param callId ID của cuộc gọi nhóm
+     * @param options Thông tin `hostCall`, `userId`, `status`, `audioState`, `videoState` và `data`
+     * @throws {ZaloApiError}
+     */
+    return async function shareScreenGroupCall(callId, options) {
+        if (!callId)
+            throw new ZaloApiError("Missing callId");
+        if (!options?.hostCall)
+            throw new ZaloApiError("Missing hostCall");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const dataStr = options.data === undefined
+            ? "{}"
+            : typeof options.data === "string"
+                ? options.data
+                : JSON.stringify(options.data);
+        const params = {
+            userId: String(options.userId ?? ctx.uid),
+            callId,
+            hostCall: String(options.hostCall),
+            status: options.status ?? 1,
+            audiostate: options.audioState ?? 1,
+            videostate: options.videoState ?? 1,
+            data: dataStr,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt shareScreenGroupCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/group/sharescreen`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/call/unholdVoiceCall.d.ts

@@ -0,0 +1,5 @@
+export type UnholdVoiceCallOptions = {
+    isResponse?: boolean;
+};
+export type UnholdVoiceCallResponse = Record<string, unknown>;
+export declare const unholdVoiceCallFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (toId: string, options?: UnholdVoiceCallOptions) => Promise<UnholdVoiceCallResponse>;

package/dist/apis/call/unholdVoiceCall.js

@@ -0,0 +1,34 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const unholdVoiceCallFactory = apiFactory()((api, _ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Gửi yêu cầu tiếp tục cuộc gọi đang tạm giữ (`/api/voicecall/unholdreq`, command `11309`, signal `413`)
+     * hoặc phản hồi tiếp tục cuộc gọi (`/api/voicecall/unholdresp`, command `11310`, signal `414`).
+     *
+     * @param toId User ID của đối phương trong cuộc gọi
+     * @param options Đặt `isResponse = true` nếu là gói phản hồi (`unholdresp`)
+     * @throws {ZaloApiError}
+     */
+    return async function unholdVoiceCall(toId, options = {}) {
+        if (!toId)
+            throw new ZaloApiError("Missing toId");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const params = {
+            toId: String(toId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt unholdVoiceCall params");
+        const endpoint = options.isResponse ? "unholdresp" : "unholdreq";
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/${endpoint}`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/call/updateCallMediaState.d.ts

@@ -0,0 +1,7 @@
+export type UpdateCallMediaStateOptions = {
+    isOnCam?: boolean | number;
+    isOnMic?: boolean | number;
+    data?: string | Record<string, unknown>;
+};
+export type UpdateCallMediaStateResponse = Record<string, unknown>;
+export declare const updateCallMediaStateFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (calleeId: string, callId: number, options: UpdateCallMediaStateOptions) => Promise<UpdateCallMediaStateResponse>;

package/dist/apis/call/updateCallMediaState.js

@@ -0,0 +1,61 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const updateCallMediaStateFactory = apiFactory()((api, _ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Đồng bộ trạng thái bật/tắt Camera và Microphone trong cuộc gọi 1-1 (`/api/voicecall/conf`, command `12006`).
+     * Khớp chính xác với `ZMessageSerializer::sendOnOffMicCam` (`0x100026cdc`):
+     * - Khi bật/tắt Camera (`UiOnOffCameraEvent`): `isOnCam = 1 | 0`, `isOnMic = -1`, `data = ""`
+     * - Khi bật/tắt Mic (`UiMuteEvent`): `isOnCam = -1`, `isOnMic = 1 | 0`, `data = ""`
+     *
+     * @param calleeId User ID của đối phương
+     * @param callId ID của cuộc gọi
+     * @param options Trạng thái `isOnCam`, `isOnMic` và `data` bổ sung
+     * @throws {ZaloApiError}
+     */
+    return async function updateCallMediaState(calleeId, callId, options) {
+        if (!calleeId)
+            throw new ZaloApiError("Missing calleeId");
+        if (!callId)
+            throw new ZaloApiError("Missing callId");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const dataStr = options.data === undefined
+            ? ""
+            : typeof options.data === "string"
+                ? options.data
+                : JSON.stringify(options.data);
+        const isOnCamVal = options.isOnCam === undefined
+            ? -1
+            : typeof options.isOnCam === "boolean"
+                ? options.isOnCam
+                    ? 1
+                    : 0
+                : Number(options.isOnCam);
+        const isOnMicVal = options.isOnMic === undefined
+            ? -1
+            : typeof options.isOnMic === "boolean"
+                ? options.isOnMic
+                    ? 1
+                    : 0
+                : Number(options.isOnMic);
+        const params = {
+            calleeId: String(calleeId),
+            callId,
+            isOnCam: isOnCamVal,
+            isOnMic: isOnMicVal,
+            data: dataStr,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt updateCallMediaState params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/conf`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/sync/downloadTransferSync.js

@@ -10,13 +10,31 @@ export const downloadTransferSyncFactory = apiFactory()((api, ctx, utils) => {
     return async function downloadTransferSync(options) {
         let downloadUrl = "";
         if (typeof options === "string") {
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(options);
+            }
+            catch {
+                throw new ZaloApiError("Invalid downloadTransferSync URL");
+            }
+            if (parsedUrl.protocol !== "https:" && parsedUrl.protocol !== "http:") {
+                throw new ZaloApiError(`Unsupported protocol in downloadTransferSync URL: ${parsedUrl.protocol}`);
+            }
+            if (parsedUrl.hostname === "169.254.169.254" || parsedUrl.hostname === "metadata.google.internal") {
+                throw new ZaloApiError("Blocked internal metadata hostname in downloadTransferSync URL");
+            }
             downloadUrl = options;
         }
         else {
             if (!options.key || !options.exp || !options.sig) {
                 throw new ZaloApiError("Missing key, exp or sig in options");
             }
-            downloadUrl = `${ZALO_DOMAINS.TRANSFER_SYNC}${ZALO_ENDPOINTS.TRANSFER_SYNC.DOWNLOAD_V2}?key=${options.key}&exp=${options.exp}&sig=${options.sig}`;
+            const qs = new URLSearchParams({
+                key: String(options.key),
+                exp: String(options.exp),
+                sig: String(options.sig),
+            });
+            downloadUrl = `${ZALO_DOMAINS.TRANSFER_SYNC}${ZALO_ENDPOINTS.TRANSFER_SYNC.DOWNLOAD_V2}?${qs.toString()}`;
         }
         const response = await utils.request(downloadUrl, {
             method: "GET",