@softtynet/zca-js 2.2.8 → 2.2.9

package/dist/cjs/apis/getListPinTopics.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getListPinTopicsFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group_board[0]}/api/board/pin/list`);
+    /**
+     * Lấy danh sách chủ đề / tin nhắn đã ghim trong bảng tin nhóm (command 12001)
+     *
+     * @param groupId ID nhóm
+     * @param boardVersion Phiên bản bảng ghim hiện tại (mặc định `0`)
+     * @throws {ZaloApiError}
+     */
+    return async function getListPinTopics(groupId, boardVersion = 0) {
+        const params = {
+            groupId,
+            boardVersion,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getListPinTopicsFactory = getListPinTopicsFactory;

package/dist/cjs/apis/getMediaStorePreview.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getMediaStorePreviewFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.media_store[0]}/api/mediastore/preview`);
+    /**
+     * Lấy danh sách xem trước nhanh Kho Lưu Trữ (Ảnh/Video, File, Link) của nhóm (command 11843)
+     *
+     * @param groupId ID của nhóm
+     * @param limit Số lượng mục tối đa (mặc định: 50)
+     * @throws {ZaloApiError}
+     */
+    return async function getMediaStorePreview(groupId, limit = 50) {
+        if (!groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        const cleanGroupId = groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const params = {
+            limit,
+            group_id: cleanGroupId,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "POST",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getMediaStorePreviewFactory = getMediaStorePreviewFactory;

package/dist/cjs/apis/getMiniProfile.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getMiniProfileFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getminiprofiles`);
+    /**
+     * Lấy nhanh thông tin hồ sơ rút gọn (Avatar, Global ID, gói Biz) của danh sách người dùng (command 12134)
+     *
+     * @param friendIds Mảng UID cần lấy thông tin
+     * @param avatarSize Kích thước ảnh đại diện (mặc định: 120)
+     * @throws {ZaloApiError}
+     */
+    return async function getMiniProfile(friendIds, avatarSize = 120) {
+        if (!Array.isArray(friendIds) || friendIds.length === 0) {
+            return {};
+        }
+        const params = {
+            friend_ids: friendIds,
+            avatar_size: avatarSize,
+            incInvalid: 1,
+            srcReq: -1,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getMiniProfileFactory = getMiniProfileFactory;

package/dist/cjs/apis/getPersonalizedStickerList.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getPersonalizedStickerListFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/personalized/list`);
+    /**
+     * Lấy danh sách Sticker cá nhân hóa của tài khoản (command 11745)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getPersonalizedStickerList() {
+        const params = {
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getPersonalizedStickerListFactory = getPersonalizedStickerListFactory;

package/dist/cjs/apis/getPhonebookV2.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getPhonebookV2Factory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/phonebook/v2`);
+    /**
+     * Lấy danh bạ bạn bè đồng bộ từ số điện thoại chuẩn V2 (command 12428)
+     *
+     * @param phonebookVersion Phiên bản danh bạ (mặc định: 0 để lấy toàn bộ)
+     * @throws {ZaloApiError}
+     */
+    return async function getPhonebookV2(phonebookVersion = 0) {
+        const encryptedParams = utils.encodeAES(JSON.stringify({ phonebook_version: phonebookVersion }));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getPhonebookV2Factory = getPhonebookV2Factory;

package/dist/cjs/apis/getProfileRank.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getProfileRankFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/profile/getrank`);
+    /**
+     * Lấy hạng tài khoản Zalo của một người dùng (ví dụ `"WHITE"`, `"GOLD"` - command 12012)
+     *
+     * @param profileId UID của người dùng cần kiểm tra (mặc định: UID của tài khoản đang đăng nhập)
+     * @throws {ZaloApiError}
+     */
+    return async function getProfileRank(profileId) {
+        const params = {
+            profile_id: profileId !== null && profileId !== void 0 ? profileId : ctx.uid,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getProfileRankFactory = getProfileRankFactory;

package/dist/cjs/apis/getProfileVerificationStatus.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getProfileVerificationStatusFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/profile/verification/status`);
+    /**
+     * Kiểm tra trạng thái xác thực định danh (eKYC) của tài khoản Zalo (command 12150)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getProfileVerificationStatus() {
+        const encryptedParams = utils.encodeAES(JSON.stringify({ imei: ctx.imei }));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getProfileVerificationStatusFactory = getProfileVerificationStatusFactory;

package/dist/cjs/apis/getQuotaCommunity.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getQuotaCommunityFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/quota/community`);
+    /**
+     * Kiểm tra hạn mức nâng cấp nhóm lên Cộng đồng của tài khoản (command 12181)
+     *
+     * @param groupId (Tùy chọn) ID của nhóm cần kiểm tra
+     * @param language Ngôn ngữ thông báo (mặc định: `"vi"`)
+     * @throws {ZaloApiError}
+     */
+    return async function getQuotaCommunity(groupId = null, language = "vi") {
+        const cleanGroupId = groupId && groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const params = {
+            language,
+            grId: cleanGroupId,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getQuotaCommunityFactory = getQuotaCommunityFactory;

package/dist/cjs/apis/getRecentSearchList.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getRecentSearchListFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.recent_search[0]}/api/recentsearch/list`);
+    /**
+     * Lấy danh sách lịch sử tìm kiếm gần đây trên Zalo (command 12125)
+     *
+     * @param version Phiên bản lịch sử tìm kiếm (mặc định: 0)
+     * @throws {ZaloApiError}
+     */
+    return async function getRecentSearchList(version = 0) {
+        const params = {
+            version,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getRecentSearchListFactory = getRecentSearchListFactory;

package/dist/cjs/apis/getStickerCategoriesV2.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getStickerCategoriesV2Factory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/category/list/v2`);
+    /**
+     * Lấy danh sách danh mục bộ nhãn dán (Sticker Categories V2 - command 12020)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getStickerCategoriesV2() {
+        const encryptedParams = utils.encodeAES("");
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getStickerCategoriesV2Factory = getStickerCategoriesV2Factory;

package/dist/cjs/apis/getStickerCategoryData.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getStickerCategoryDataFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/category/detail`);
+    /**
+     * Lấy thông tin chi tiết một bộ nhãn dán theo `cid` (command 11156)
+     *
+     * @param cid ID bộ nhãn dán (Category ID)
+     * @throws {ZaloApiError}
+     */
+    return async function getStickerCategoryData(cid) {
+        const params = {
+            cid,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getStickerCategoryDataFactory = getStickerCategoryDataFactory;

package/dist/cjs/apis/getStickerHello.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getStickerHelloFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/suggestion`);
+    /**
+     * Lấy danh sách Sticker chào hỏi gợi ý khi bắt đầu trò chuyện mới (command 11751)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getStickerHello() {
+        const params = {
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response, (result) => {
+            if (typeof result.data === "string") {
+                try {
+                    return JSON.parse(result.data);
+                }
+                catch (_a) {
+                    return result.data;
+                }
+            }
+            return result.data;
+        });
+    };
+});
+
+exports.getStickerHelloFactory = getStickerHelloFactory;

package/dist/cjs/apis/getStickerSuggestKeywords.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getStickerSuggestKeywordsFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/suggest/keywords`);
+    /**
+     * Lấy bộ từ khóa gợi ý Sticker tự động khi gõ tin nhắn (command 11740)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getStickerSuggestKeywords() {
+        const params = {
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getStickerSuggestKeywordsFactory = getStickerSuggestKeywordsFactory;

package/dist/cjs/apis/getStickerSuggestion.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getStickerSuggestionFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.sticker[0]}/api/message/sticker/suggest/stickers`);
+    /**
+     * Gợi ý Sticker/GIF theo từ khóa đang nhập (command 11741)
+     *
+     * @param options Từ khóa và tùy chọn kèm theo (`gif`, `guggy`)
+     * @throws {ZaloApiError}
+     */
+    return async function getStickerSuggestion(options) {
+        var _a, _b;
+        const normalized = typeof options === "string" ? { keyword: options } : options;
+        const params = {
+            keyword: normalized.keyword,
+            gif: (_a = normalized.gif) !== null && _a !== void 0 ? _a : 1,
+            guggy: (_b = normalized.guggy) !== null && _b !== void 0 ? _b : 0,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getStickerSuggestionFactory = getStickerSuggestionFactory;

package/dist/cjs/apis/getUsageMyCloud.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getUsageMyCloudFactory = utils.apiFactory()((api, _ctx, utils$1) => {
+    var _a;
+    const baseDomain = ((_a = api.zpwServiceMap.zcloud) === null || _a === void 0 ? void 0 : _a[0]) || "https://zcld.chat.zalo.me";
+    const serviceURL = utils$1.makeURL(`${baseDomain}/cloudmedia/info/pc/v1/usage-mycloud`);
+    /**
+     * Kiểm tra hạn mức và dung lượng sử dụng Cloud của tôi (MyCloud - command 12748)
+     *
+     * @param viewerKeyInfo (Tùy chọn) Cặp `{ viewer_key, enk }` từ `api.getCloudViewerKey()`. Nếu không truyền sẽ tự động lấy mới.
+     * @throws {ZaloApiError}
+     */
+    return async function getUsageMyCloud(viewerKeyInfo) {
+        const keyInfo = viewerKeyInfo !== null && viewerKeyInfo !== void 0 ? viewerKeyInfo : (await api.getCloudViewerKey());
+        if (!(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.viewer_key) || !(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.enk)) {
+            throw new ZaloApiError.ZaloApiError("Invalid CloudViewerKey");
+        }
+        const response = await utils$1.request(serviceURL, {
+            method: "GET",
+            headers: {
+                "cloud-viewer-key": keyInfo.viewer_key,
+            },
+        });
+        const json = (await response.json());
+        if (json.error_code !== 0 && json.error_code !== -904) {
+            throw new ZaloApiError.ZaloApiError(json.error_message || "getUsageMyCloud failed", json.error_code);
+        }
+        if (!json.data) {
+            throw new ZaloApiError.ZaloApiError("Empty MyCloud usage data", json.error_code);
+        }
+        const decrypted = utils.decryptZCloudAES(json.data, keyInfo.enk);
+        return JSON.parse(decrypted);
+    };
+});
+
+exports.getUsageMyCloudFactory = getUsageMyCloudFactory;

package/dist/cjs/apis/getUsageZCloud.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getUsageZCloudFactory = utils.apiFactory()((api, _ctx, utils$1) => {
+    var _a;
+    const baseDomain = ((_a = api.zpwServiceMap.zcloud) === null || _a === void 0 ? void 0 : _a[0]) || "https://zcld.chat.zalo.me";
+    const serviceURL = utils$1.makeURL(`${baseDomain}/cloudmedia/info/pc/v2/usage`);
+    /**
+     * Kiểm tra dung lượng sử dụng ZCloud V2 (bao gồm MyCloud và Sao lưu tin nhắn - command 12749)
+     *
+     * @param viewerKeyInfo (Tùy chọn) Cặp `{ viewer_key, enk }` từ `api.getCloudViewerKey()`. Nếu không truyền sẽ tự động lấy mới.
+     * @throws {ZaloApiError}
+     */
+    return async function getUsageZCloud(viewerKeyInfo) {
+        const keyInfo = viewerKeyInfo !== null && viewerKeyInfo !== void 0 ? viewerKeyInfo : (await api.getCloudViewerKey());
+        if (!(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.viewer_key) || !(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.enk)) {
+            throw new ZaloApiError.ZaloApiError("Invalid CloudViewerKey");
+        }
+        const response = await utils$1.request(serviceURL, {
+            method: "GET",
+            headers: {
+                "cloud-viewer-key": keyInfo.viewer_key,
+            },
+        });
+        const json = (await response.json());
+        if (json.error_code !== 0 && json.error_code !== -904) {
+            throw new ZaloApiError.ZaloApiError(json.error_message || "getUsageZCloud failed", json.error_code);
+        }
+        if (!json.data) {
+            throw new ZaloApiError.ZaloApiError("Empty ZCloud usage data", json.error_code);
+        }
+        const decrypted = utils.decryptZCloudAES(json.data, keyInfo.enk);
+        return JSON.parse(decrypted);
+    };
+});
+
+exports.getUsageZCloudFactory = getUsageZCloudFactory;

package/dist/cjs/apis/keepAlive.cjs

@@ -6,7 +6,7 @@ var utils = require('../utils.cjs');
 const keepAliveFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.chat[0]}/keepalive`);
     /**
-     * Keep Alive?
+     * Gửi tín hiệu duy trì phiên kết nối HTTP tới máy chủ Chat (KeepAlive - command 11770)
      *
      * @throws {ZaloApiError}
      */
@@ -17,10 +17,12 @@ const keepAliveFactory = utils.apiFactory()((api, ctx, utils) => {
         const encryptedParams = utils.encodeAES(JSON.stringify(params));
         if (!encryptedParams)
             throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
-        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+        const response = await utils.request(utils.makeURL(serviceURL, {
+            params: encryptedParams,
+        }), {
             method: "GET",
         });
-        return utils.resolve(response, undefined, false);
+        return utils.resolve(response);
     };
 });
 

package/dist/cjs/apis/listen.cjs

@@ -373,6 +373,16 @@ class Listener extends EventEmitter {
                             const callEvent = CallEvent.initializeCallEvent(callEventData, control.content.act, control.content.act_type);
                             this.emit("call_event", callEvent);
                         }
+                        else if (control.content.act_type == "voice2text") {
+                            const v2tData = typeof control.content.data == "string"
+                                ? JSON.parse(control.content.data)
+                                : control.content.data;
+                            this.emit("voice2text_event", {
+                                act: control.content.act,
+                                act_type: "voice2text",
+                                data: v2tData,
+                            });
+                        }
                     }
                 }
                 if (cmd == 612) {

package/dist/cjs/apis/readContactTab.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const readContactTabFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.friend[0]}/api/friend/read-contact-tab`);
+    /**
+     * Đánh dấu đã đọc tab Danh bạ (command 12231)
+     *
+     * @param ts Dấu thời gian (mặc định: `Date.now()`)
+     * @throws {ZaloApiError}
+     */
+    return async function readContactTab(ts = Date.now()) {
+        const params = {
+            ts,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.readContactTabFactory = readContactTabFactory;

package/dist/cjs/apis/removeConversationMedia.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const removeConversationMediaFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.media_store[0]}/api/mediastore/remove`);
+    /**
+     * Xóa mục Ảnh/Video, File hoặc Link khỏi Kho Lưu Trữ của nhóm (command 11842)
+     *
+     * @param options Thông tin mục cần xóa (`groupId`, `mediaType`, `mediaId`)
+     * @throws {ZaloApiError}
+     */
+    return async function removeConversationMedia(options) {
+        if (!options.groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        const cleanGroupId = options.groupId.startsWith("g") ? options.groupId.slice(1) : options.groupId;
+        const params = {
+            media_type: options.mediaType,
+            media_id: options.mediaId,
+            group_id: cleanGroupId,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "POST",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.removeConversationMediaFactory = removeConversationMediaFactory;