@softtynet/zca-js 2.3.3 → 2.3.5

package/dist/apis/call/ringRingGroupCall.js

@@ -0,0 +1,45 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+import { CallType } from "./sendVoiceCall.js";
+export const ringRingGroupCallFactory = apiFactory()((api, ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Báo hiệu thiết bị đang đổ chuông cho cuộc gọi nhóm (`/api/voicecall/group/ringring`, command `12439`).
+     *
+     * @param callId ID của cuộc gọi nhóm
+     * @param options Thông tin `hostCall`, `calleeId`, `callType`, `partners` và `data`
+     * @throws {ZaloApiError}
+     */
+    return async function ringRingGroupCall(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 = {
+            calleeId: String(options.calleeId ?? ctx.uid),
+            callId,
+            callType: options.callType ?? CallType.GroupAudio,
+            hostCall: String(options.hostCall),
+            data: dataStr,
+            partners: (options.partners ?? []).map(String),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt ringRingGroupCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/group/ringring`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

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

@@ -0,0 +1,5 @@
+export type RingRingVoiceCallOptions = {
+    status?: number;
+};
+export type RingRingVoiceCallResponse = Record<string, unknown>;
+export declare const ringRingVoiceCallFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (callerId: string, callId: number, options?: RingRingVoiceCallOptions) => Promise<RingRingVoiceCallResponse>;

package/dist/apis/call/ringRingVoiceCall.js

@@ -0,0 +1,38 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const ringRingVoiceCallFactory = apiFactory()((api, ctx, utils) => {
+    const voiceCallService = api.zpwServiceMap.voice_call?.[0];
+    /**
+     * Báo hiệu thiết bị của người nhận đang đổ chuông cho người gọi (`/api/voicecall/ringring`, command `11302`, signal `407`).
+     *
+     * @param callerId User ID của người gọi đến
+     * @param callId ID của cuộc gọi
+     * @param options Tuỳ chọn mã trạng thái (`status`, mặc định `0`)
+     * @throws {ZaloApiError}
+     */
+    return async function ringRingVoiceCall(callerId, callId, options = {}) {
+        if (!callerId)
+            throw new ZaloApiError("Missing callerId");
+        if (!callId)
+            throw new ZaloApiError("Missing callId");
+        if (!voiceCallService)
+            throw new ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const params = {
+            callerId: String(callerId),
+            callId,
+            status: options.status ?? 0,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt ringRingVoiceCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/ringring`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

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

@@ -0,0 +1,11 @@
+import { CallType } from "./sendVoiceCall.js";
+export type SendRequestGroupCallOptions = {
+    calleeId?: string;
+    callId: number;
+    callType?: CallType | number;
+    data?: string | Record<string, unknown>;
+    session: string;
+    partners: string[];
+};
+export type SendRequestGroupCallResponse = Record<string, unknown>;
+export declare const sendRequestGroupCallFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (groupId: string, options: SendRequestGroupCallOptions) => Promise<SendRequestGroupCallResponse>;

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/chat/getDirectMessageStatus.d.ts

@@ -0,0 +1,14 @@
+export type DirectMessageStatusItem = {
+    tId: string;
+    seen?: string | number;
+    deliver?: string | number;
+    [key: string]: unknown;
+};
+export type GetDirectMessageStatusResponse = {
+    statusInfos: DirectMessageStatusItem[];
+    [key: string]: unknown;
+};
+export declare const getDirectMessageStatusFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (data: Array<string | {
+    tId: string;
+    [key: string]: unknown;
+}>) => Promise<GetDirectMessageStatusResponse>;

package/dist/apis/chat/getDirectMessageStatus.js

@@ -0,0 +1,52 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory, preParseJsonIds } from "../../utils.js";
+export const getDirectMessageStatusFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.chat[0]}/api/message/getStatusMsg`);
+    /**
+     * Truy vấn trạng thái Đã nhận (`deliver`) và Đã xem (`seen`) tin nhắn trong các hội thoại cá nhân 1-1 (command 12016)
+     *
+     * @param data Danh sách UID hoặc đối tượng truy vấn `{ tId }`
+     * @throws {ZaloApiError}
+     */
+    return async function getDirectMessageStatus(data) {
+        if (!Array.isArray(data) || data.length === 0) {
+            throw new ZaloApiError("Missing data");
+        }
+        const formattedData = data.map((item) => (typeof item === "string" ? { tId: item } : item));
+        const params = {
+            param: JSON.stringify({
+                data: formattedData,
+            }),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response, (result) => {
+            let rawData = result.data;
+            if (typeof rawData === "string" && rawData.length > 0) {
+                try {
+                    const parsed = JSON.parse(preParseJsonIds(rawData));
+                    rawData = "data" in parsed && parsed.data ? parsed.data : parsed;
+                }
+                catch {
+                    // Giữ nguyên nếu không phải chuỗi JSON lồng
+                }
+            }
+            if (rawData && typeof rawData === "object") {
+                const obj = rawData;
+                return {
+                    ...obj,
+                    statusInfos: Array.isArray(obj.statusInfos) ? obj.statusInfos : [],
+                };
+            }
+            return { statusInfos: [] };
+        });
+    };
+});

package/dist/apis/chat/getSuggestedConversations.d.ts

@@ -0,0 +1,5 @@
+export type GetSuggestedConversationsResponse = {
+    conversations?: unknown[];
+    [key: string]: unknown;
+};
+export declare const getSuggestedConversationsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (language?: string) => Promise<GetSuggestedConversationsResponse>;

package/dist/apis/chat/getSuggestedConversations.js

@@ -0,0 +1,24 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const getSuggestedConversationsFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.conversation[0]}/api/suggestconvers/list`);
+    /**
+     * Lấy danh sách các cuộc hội thoại được gợi ý (command 11233)
+     *
+     * @param language Ngôn ngữ hiển thị (mặc định theo `ctx.language` hoặc `"vi"`)
+     * @throws {ZaloApiError}
+     */
+    return async function getSuggestedConversations(language) {
+        const params = {
+            language: language ?? ctx.language ?? "vi",
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/chat/updatePinConversations.d.ts

@@ -0,0 +1,24 @@
+export type UpdatePinConversationsOptions = {
+    /**
+     * Danh sách ID hội thoại cần ghim / bỏ ghim (prefix `g` cho nhóm hoặc UID cho cá nhân).
+     */
+    conversations: string[];
+    /**
+     * Loại thao tác khi dùng V2 (`1`: ghim, `2`: bỏ ghim). Nếu truyền `actionType`, API sẽ gọi `/api/pinconvers/updatev2` (cmd 12122).
+     */
+    actionType?: number;
+    /**
+     * Tab hội thoại khi dùng V2 (tùy chọn).
+     */
+    tab?: number;
+    /**
+     * Phiên bản danh sách ghim khi dùng V1 (`/api/pinconvers/update`, cmd 12121, mặc định: `0`).
+     */
+    version?: number;
+};
+export type UpdatePinConversationsResponse = {
+    version?: number;
+    conversations?: string[];
+    [key: string]: unknown;
+};
+export declare const updatePinConversationsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (options: UpdatePinConversationsOptions) => Promise<UpdatePinConversationsResponse>;

package/dist/apis/chat/updatePinConversations.js

@@ -0,0 +1,40 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const updatePinConversationsFactory = apiFactory()((api, _ctx, utils) => {
+    const v1ServiceURL = utils.makeURL(`${api.zpwServiceMap.conversation[0]}/api/pinconvers/update`);
+    const v2ServiceURL = utils.makeURL(`${api.zpwServiceMap.conversation[0]}/api/pinconvers/updatev2`);
+    /**
+     * Cập nhật danh sách hội thoại ghim qua `/api/pinconvers/update` (command 12121) hoặc `/api/pinconvers/updatev2` (command 12122)
+     *
+     * @param options Cấu hình danh sách hội thoại ghim
+     * @throws {ZaloApiError}
+     */
+    return async function updatePinConversations(options) {
+        if (!options || !Array.isArray(options.conversations)) {
+            throw new ZaloApiError("Missing conversations");
+        }
+        const useV2 = options.actionType !== undefined;
+        const targetURL = useV2 ? v2ServiceURL : v1ServiceURL;
+        const params = useV2
+            ? {
+                actionType: options.actionType,
+                conversations: options.conversations,
+                tab: options.tab,
+            }
+            : {
+                version: options.version ?? 0,
+                conversations: options.conversations,
+            };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(targetURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/friend/getFriendProfilesV2.d.ts

@@ -0,0 +1,26 @@
+import type { GroupMemberProfile } from "../group/getGroupMembersInfo.js";
+export type GetFriendProfilesV2Options = {
+    /**
+     * Phiên bản danh bạ (mặc định: `0`).
+     */
+    phonebookVersion?: number;
+    /**
+     * Kích thước ảnh đại diện (mặc định: `120`).
+     */
+    avatarSize?: number;
+    /**
+     * Ngôn ngữ (mặc định: `"vi"`).
+     */
+    language?: string;
+    /**
+     * Trả kèm trạng thái online của bạn bè (mặc định: `true`).
+     */
+    showOnlineStatus?: boolean;
+};
+export type GetFriendProfilesV2Response = {
+    profiles: Record<string, GroupMemberProfile>;
+    unchangeds_profile?: string[];
+    phonebook_version?: number;
+    [key: string]: unknown;
+};
+export declare const getFriendProfilesV2Factory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (friendIds: string | string[], options?: GetFriendProfilesV2Options) => Promise<GetFriendProfilesV2Response>;