@softtynet/zca-js 2.3.3 → 2.3.4

package/dist/apis.js

@@ -7,6 +7,7 @@ import { addQuickMessageFactory } from "./apis/business/addQuickMessage.js";
 import { addReactionFactory } from "./apis/chat/addReaction.js";
 import { addUnreadMarkFactory } from "./apis/chat/addUnreadMark.js";
 import { addUserToGroupFactory } from "./apis/group/addUserToGroup.js";
+import { analyseGroupFactory } from "./apis/group/analyseGroup.js";
 import { blockUserFactory } from "./apis/friend/blockUser.js";
 import { blockViewFeedFactory } from "./apis/friend/blockViewFeed.js";
 import { cancelPullMobileFactory } from "./apis/sync/cancelPullMobile.js";
@@ -16,6 +17,7 @@ import { changeFriendAliasFactory } from "./apis/friend/changeFriendAlias.js";
 import { changeGroupAvatarFactory } from "./apis/group/changeGroupAvatar.js";
 import { changeGroupNameFactory } from "./apis/group/changeGroupName.js";
 import { changeGroupOwnerFactory } from "./apis/group/changeGroupOwner.js";
+import { checkQuotaCommunityMemberFactory } from "./apis/group/checkQuotaCommunityMember.js";
 import { clearUnreadFriendRequestsFactory } from "./apis/friend/clearUnreadFriendRequests.js";
 import { createAutoReplyFactory } from "./apis/business/createAutoReply.js";
 import { createBankAccountFactory } from "./apis/business/createBankAccount.js";
@@ -42,6 +44,7 @@ import { editReminderFactory } from "./apis/board/editReminder.js";
 import { enableGroupLinkFactory } from "./apis/group/enableGroupLink.js";
 import { encryptGidsFactory } from "./apis/auth/encryptGids.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";
@@ -65,6 +68,8 @@ import { getCloudViewerKeyFactory } from "./apis/zcloud/getCloudViewerKey.js";
 import { getContextFactory } from "./apis/auth/getContext.js";
 import { getConversationMediaFactory } from "./apis/media/getConversationMedia.js";
 import { getCookieFactory } from "./apis/auth/getCookie.js";
+import { getDirectMessageStatusFactory } from "./apis/chat/getDirectMessageStatus.js";
+import { getE2eeGroupListFactory } from "./apis/group/getE2eeGroupList.js";
 import { getEmojiStatusConfigFactory } from "./apis/profile/getEmojiStatusConfig.js";
 import { getExtraFriendInfoFactory } from "./apis/friend/getExtraFriendInfo.js";
 import { getExtraGroupInfoFactory } from "./apis/group/getExtraGroupInfo.js";
@@ -73,13 +78,16 @@ import { getFamilyUsageFactory } from "./apis/zcloud/getFamilyUsage.js";
 import { getFamilyViewerKeyFactory } from "./apis/zcloud/getFamilyViewerKey.js";
 import { getFriendBoardListFactory } from "./apis/friend/getFriendBoardList.js";
 import { getFriendOnlinesFactory } from "./apis/friend/getFriendOnlines.js";
+import { getFriendProfilesV2Factory } from "./apis/friend/getFriendProfilesV2.js";
 import { getFriendRecommendationsFactory } from "./apis/friend/getFriendRecommendations.js";
 import { getFriendRequestStatusFactory } from "./apis/friend/getFriendRequestStatus.js";
+import { getFriendsActivePCWebFactory } from "./apis/friend/getFriendsActivePCWeb.js";
 import { getFriendsEmojiStatusFactory } from "./apis/friend/getFriendsEmojiStatus.js";
 import { getFullAvatarFactory } from "./apis/profile/getFullAvatar.js";
 import { getGroupBlockedMemberFactory } from "./apis/group/getGroupBlockedMember.js";
 import { getGroupChatHistoryFactory } from "./apis/group/getGroupChatHistory.js";
 import { getGroupCloudMessageJumpFactory } from "./apis/group/getGroupCloudMessageJump.js";
+import { getGroupCloudMessagePathFactory } from "./apis/group/getGroupCloudMessagePath.js";
 import { getGroupHistoryLegacyFactory } from "./apis/group/getGroupHistoryLegacy.js";
 import { getGroupInfoFactory } from "./apis/group/getGroupInfo.js";
 import { getGroupInfoV2Factory } from "./apis/group/getGroupInfoV2.js";
@@ -103,12 +111,15 @@ import { getListPinTopicsFactory } from "./apis/board/getListPinTopics.js";
 import { getListReminderFactory } from "./apis/board/getListReminder.js";
 import { getMediaStorePreviewFactory } from "./apis/media/getMediaStorePreview.js";
 import { getMiniProfileFactory } from "./apis/profile/getMiniProfile.js";
+import { getMultiGroupCloudMessagesFactory } from "./apis/group/getMultiGroupCloudMessages.js";
 import { getMultiUsersByPhonesFactory } from "./apis/friend/getMultiUsersByPhones.js";
 import { getMuteFactory } from "./apis/chat/getMute.js";
 import { getNoisedIdsFactory } from "./apis/auth/getNoisedIds.js";
 import { getOwnIdFactory } from "./apis/auth/getOwnId.js";
 import { getPendingGroupMembersFactory } from "./apis/group/getPendingGroupMembers.js";
 import { getPersonalizedStickerListFactory } from "./apis/sticker/getPersonalizedStickerList.js";
+import { getPersonalMediaFactory } from "./apis/media/getPersonalMedia.js";
+import { getPersonalMediaPreviewFactory } from "./apis/media/getPersonalMediaPreview.js";
 import { getPhonebookV2Factory } from "./apis/friend/getPhonebookV2.js";
 import { getPinConversationsFactory } from "./apis/chat/getPinConversations.js";
 import { getPollDetailFactory } from "./apis/board/getPollDetail.js";
@@ -132,6 +143,7 @@ import { getStickersFactory } from "./apis/sticker/getStickers.js";
 import { getStickersDetailFactory } from "./apis/sticker/getStickersDetail.js";
 import { getStickerSuggestionFactory } from "./apis/sticker/getStickerSuggestion.js";
 import { getStickerSuggestKeywordsFactory } from "./apis/sticker/getStickerSuggestKeywords.js";
+import { getSuggestedConversationsFactory } from "./apis/chat/getSuggestedConversations.js";
 import { getSyncDataFactory } from "./apis/sync/getSyncData.js";
 import { getUnreadMarkFactory } from "./apis/chat/getUnreadMark.js";
 import { getUsageMyCloudFactory } from "./apis/zcloud/getUsageMyCloud.js";
@@ -156,6 +168,7 @@ import { removeFriendFactory } from "./apis/friend/removeFriend.js";
 import { removeFriendAliasFactory } from "./apis/friend/removeFriendAlias.js";
 import { removeGroupBlockedMemberFactory } from "./apis/group/removeGroupBlockedMember.js";
 import { removeGroupDeputyFactory } from "./apis/group/removeGroupDeputy.js";
+import { removePersonalMediaFactory } from "./apis/media/removePersonalMedia.js";
 import { removeQuickMessageFactory } from "./apis/business/removeQuickMessage.js";
 import { removeReminderFactory } from "./apis/board/removeReminder.js";
 import { removeUnreadMarkFactory } from "./apis/chat/removeUnreadMark.js";
@@ -197,6 +210,7 @@ import { updateGroupSettingsFactory } from "./apis/group/updateGroupSettings.js"
 import { updateHiddenConversPinFactory } from "./apis/chat/updateHiddenConversPin.js";
 import { updateLabelsFactory } from "./apis/business/updateLabels.js";
 import { updateLangFactory } from "./apis/auth/updateLang.js";
+import { updatePinConversationsFactory } from "./apis/chat/updatePinConversations.js";
 import { updateProductCatalogFactory } from "./apis/business/updateProductCatalog.js";
 import { updateProfileFactory } from "./apis/profile/updateProfile.js";
 import { updateProfileBioFactory } from "./apis/profile/updateProfileBio.js";
@@ -207,6 +221,7 @@ import { upgradeGroupToCommunityFactory } from "./apis/group/upgradeGroupToCommu
 import { uploadAttachmentFactory } from "./apis/media/uploadAttachment.js";
 import { uploadProductPhotoFactory } from "./apis/business/uploadProductPhoto.js";
 import { verifyCloudMediaFactory } from "./apis/zcloud/verifyCloudMedia.js";
+import { verifyFriendFactory } from "./apis/friend/verifyFriend.js";
 import { voiceToTextFactory } from "./apis/media/voiceToText.js";
 import { votePollFactory } from "./apis/board/votePoll.js";
 import { customFactory } from "./apis/custom.js";
@@ -231,6 +246,7 @@ export class API {
             const createNamespace = (api) => ({
                 get decryptGids() { return api.decryptGids; },
                 get encryptGids() { return api.encryptGids; },
+                get exportSession() { return api.exportSession; },
                 get getContext() { return api.getContext; },
                 get getCookie() { return api.getCookie; },
                 get getListDevice() { return api.getListDevice; },
@@ -326,12 +342,14 @@ export class API {
                 get forwardMessage() { return api.forwardMessage; },
                 get getArchivedChatList() { return api.getArchivedChatList; },
                 get getAutoDeleteChat() { return api.getAutoDeleteChat; },
+                get getDirectMessageStatus() { return api.getDirectMessageStatus; },
                 get getHiddenConversations() { return api.getHiddenConversations; },
                 get getLastSeen() { return api.getLastSeen; },
                 get getLastSeenReaction() { return api.getLastSeenReaction; },
                 get getMute() { return api.getMute; },
                 get getPinConversations() { return api.getPinConversations; },
                 get getRecentSearchList() { return api.getRecentSearchList; },
+                get getSuggestedConversations() { return api.getSuggestedConversations; },
                 get getUnreadMark() { return api.getUnreadMark; },
                 get parseLink() { return api.parseLink; },
                 get preloadConversations() { return api.preloadConversations; },
@@ -356,6 +374,7 @@ export class API {
                 get updateArchivedChatList() { return api.updateArchivedChatList; },
                 get updateAutoDeleteChat() { return api.updateAutoDeleteChat; },
                 get updateHiddenConversPin() { return api.updateHiddenConversPin; },
+                get updatePinConversations() { return api.updatePinConversations; },
                 get updateRecentSearch() { return api.updateRecentSearch; },
             });
             this._domains.chat = createNamespace(this);
@@ -380,8 +399,10 @@ export class API {
                 get getExtraFriendInfo() { return api.getExtraFriendInfo; },
                 get getFriendBoardList() { return api.getFriendBoardList; },
                 get getFriendOnlines() { return api.getFriendOnlines; },
+                get getFriendProfilesV2() { return api.getFriendProfilesV2; },
                 get getFriendRecommendations() { return api.getFriendRecommendations; },
                 get getFriendRequestStatus() { return api.getFriendRequestStatus; },
+                get getFriendsActivePCWeb() { return api.getFriendsActivePCWeb; },
                 get getFriendsEmojiStatus() { return api.getFriendsEmojiStatus; },
                 get getLastReadContactTab() { return api.getLastReadContactTab; },
                 get getMultiUsersByPhones() { return api.getMultiUsersByPhones; },
@@ -395,6 +416,7 @@ export class API {
                 get sendFriendRequest() { return api.sendFriendRequest; },
                 get unblockUser() { return api.unblockUser; },
                 get undoFriendRequest() { return api.undoFriendRequest; },
+                get verifyFriend() { return api.verifyFriend; },
             });
             this._domains.friend = createNamespace(this);
         }
@@ -406,19 +428,23 @@ export class API {
                 get addGroupBlockedMember() { return api.addGroupBlockedMember; },
                 get addGroupDeputy() { return api.addGroupDeputy; },
                 get addUserToGroup() { return api.addUserToGroup; },
+                get analyseGroup() { return api.analyseGroup; },
                 get changeGroupAvatar() { return api.changeGroupAvatar; },
                 get changeGroupName() { return api.changeGroupName; },
                 get changeGroupOwner() { return api.changeGroupOwner; },
+                get checkQuotaCommunityMember() { return api.checkQuotaCommunityMember; },
                 get createGroup() { return api.createGroup; },
                 get deleteGroupInviteBox() { return api.deleteGroupInviteBox; },
                 get disableGroupLink() { return api.disableGroupLink; },
                 get disperseGroup() { return api.disperseGroup; },
                 get enableGroupLink() { return api.enableGroupLink; },
                 get getAllGroups() { return api.getAllGroups; },
+                get getE2eeGroupList() { return api.getE2eeGroupList; },
                 get getExtraGroupInfo() { return api.getExtraGroupInfo; },
                 get getGroupBlockedMember() { return api.getGroupBlockedMember; },
                 get getGroupChatHistory() { return api.getGroupChatHistory; },
                 get getGroupCloudMessageJump() { return api.getGroupCloudMessageJump; },
+                get getGroupCloudMessagePath() { return api.getGroupCloudMessagePath; },
                 get getGroupHistoryLegacy() { return api.getGroupHistoryLegacy; },
                 get getGroupInfo() { return api.getGroupInfo; },
                 get getGroupInfoV2() { return api.getGroupInfoV2; },
@@ -429,6 +455,7 @@ export class API {
                 get getGroupListV3() { return api.getGroupListV3; },
                 get getGroupMembersInfo() { return api.getGroupMembersInfo; },
                 get getGroupMessageStatus() { return api.getGroupMessageStatus; },
+                get getMultiGroupCloudMessages() { return api.getMultiGroupCloudMessages; },
                 get getPendingGroupMembers() { return api.getPendingGroupMembers; },
                 get getQuotaCommunity() { return api.getQuotaCommunity; },
                 get getRelatedFriendGroup() { return api.getRelatedFriendGroup; },
@@ -452,7 +479,10 @@ export class API {
             const createNamespace = (api) => ({
                 get getConversationMedia() { return api.getConversationMedia; },
                 get getMediaStorePreview() { return api.getMediaStorePreview; },
+                get getPersonalMedia() { return api.getPersonalMedia; },
+                get getPersonalMediaPreview() { return api.getPersonalMediaPreview; },
                 get removeConversationMedia() { return api.removeConversationMedia; },
+                get removePersonalMedia() { return api.removePersonalMedia; },
                 get uploadAttachment() { return api.uploadAttachment; },
                 get voiceToText() { return api.voiceToText; },
             });
@@ -559,6 +589,9 @@ export class API {
     get addUserToGroup() {
         return (this._cache.addUserToGroup ??= addUserToGroupFactory(this.ctx, this));
     }
+    get analyseGroup() {
+        return (this._cache.analyseGroup ??= analyseGroupFactory(this.ctx, this));
+    }
     get blockUser() {
         return (this._cache.blockUser ??= blockUserFactory(this.ctx, this));
     }
@@ -586,6 +619,9 @@ export class API {
     get changeGroupOwner() {
         return (this._cache.changeGroupOwner ??= changeGroupOwnerFactory(this.ctx, this));
     }
+    get checkQuotaCommunityMember() {
+        return (this._cache.checkQuotaCommunityMember ??= checkQuotaCommunityMemberFactory(this.ctx, this));
+    }
     get clearUnreadFriendRequests() {
         return (this._cache.clearUnreadFriendRequests ??= clearUnreadFriendRequestsFactory(this.ctx, this));
     }
@@ -664,6 +700,9 @@ export class API {
     get endVoiceCall() {
         return (this._cache.endVoiceCall ??= endVoiceCallFactory(this.ctx, this));
     }
+    get exportSession() {
+        return (this._cache.exportSession ??= exportSessionFactory(this.ctx, this));
+    }
     get fetchAccountInfo() {
         return (this._cache.fetchAccountInfo ??= fetchAccountInfoFactory(this.ctx, this));
     }
@@ -733,6 +772,12 @@ export class API {
     get getCookie() {
         return (this._cache.getCookie ??= getCookieFactory(this.ctx, this));
     }
+    get getDirectMessageStatus() {
+        return (this._cache.getDirectMessageStatus ??= getDirectMessageStatusFactory(this.ctx, this));
+    }
+    get getE2eeGroupList() {
+        return (this._cache.getE2eeGroupList ??= getE2eeGroupListFactory(this.ctx, this));
+    }
     get getEmojiStatusConfig() {
         return (this._cache.getEmojiStatusConfig ??= getEmojiStatusConfigFactory(this.ctx, this));
     }
@@ -757,12 +802,18 @@ export class API {
     get getFriendOnlines() {
         return (this._cache.getFriendOnlines ??= getFriendOnlinesFactory(this.ctx, this));
     }
+    get getFriendProfilesV2() {
+        return (this._cache.getFriendProfilesV2 ??= getFriendProfilesV2Factory(this.ctx, this));
+    }
     get getFriendRecommendations() {
         return (this._cache.getFriendRecommendations ??= getFriendRecommendationsFactory(this.ctx, this));
     }
     get getFriendRequestStatus() {
         return (this._cache.getFriendRequestStatus ??= getFriendRequestStatusFactory(this.ctx, this));
     }
+    get getFriendsActivePCWeb() {
+        return (this._cache.getFriendsActivePCWeb ??= getFriendsActivePCWebFactory(this.ctx, this));
+    }
     get getFriendsEmojiStatus() {
         return (this._cache.getFriendsEmojiStatus ??= getFriendsEmojiStatusFactory(this.ctx, this));
     }
@@ -778,6 +829,9 @@ export class API {
     get getGroupCloudMessageJump() {
         return (this._cache.getGroupCloudMessageJump ??= getGroupCloudMessageJumpFactory(this.ctx, this));
     }
+    get getGroupCloudMessagePath() {
+        return (this._cache.getGroupCloudMessagePath ??= getGroupCloudMessagePathFactory(this.ctx, this));
+    }
     get getGroupHistoryLegacy() {
         return (this._cache.getGroupHistoryLegacy ??= getGroupHistoryLegacyFactory(this.ctx, this));
     }
@@ -847,6 +901,9 @@ export class API {
     get getMiniProfile() {
         return (this._cache.getMiniProfile ??= getMiniProfileFactory(this.ctx, this));
     }
+    get getMultiGroupCloudMessages() {
+        return (this._cache.getMultiGroupCloudMessages ??= getMultiGroupCloudMessagesFactory(this.ctx, this));
+    }
     get getMultiUsersByPhones() {
         return (this._cache.getMultiUsersByPhones ??= getMultiUsersByPhonesFactory(this.ctx, this));
     }
@@ -865,6 +922,12 @@ export class API {
     get getPersonalizedStickerList() {
         return (this._cache.getPersonalizedStickerList ??= getPersonalizedStickerListFactory(this.ctx, this));
     }
+    get getPersonalMedia() {
+        return (this._cache.getPersonalMedia ??= getPersonalMediaFactory(this.ctx, this));
+    }
+    get getPersonalMediaPreview() {
+        return (this._cache.getPersonalMediaPreview ??= getPersonalMediaPreviewFactory(this.ctx, this));
+    }
     get getPhonebookV2() {
         return (this._cache.getPhonebookV2 ??= getPhonebookV2Factory(this.ctx, this));
     }
@@ -934,6 +997,9 @@ export class API {
     get getStickerSuggestKeywords() {
         return (this._cache.getStickerSuggestKeywords ??= getStickerSuggestKeywordsFactory(this.ctx, this));
     }
+    get getSuggestedConversations() {
+        return (this._cache.getSuggestedConversations ??= getSuggestedConversationsFactory(this.ctx, this));
+    }
     get getSyncData() {
         return (this._cache.getSyncData ??= getSyncDataFactory(this.ctx, this));
     }
@@ -1006,6 +1072,9 @@ export class API {
     get removeGroupDeputy() {
         return (this._cache.removeGroupDeputy ??= removeGroupDeputyFactory(this.ctx, this));
     }
+    get removePersonalMedia() {
+        return (this._cache.removePersonalMedia ??= removePersonalMediaFactory(this.ctx, this));
+    }
     get removeQuickMessage() {
         return (this._cache.removeQuickMessage ??= removeQuickMessageFactory(this.ctx, this));
     }
@@ -1129,6 +1198,9 @@ export class API {
     get updateLang() {
         return (this._cache.updateLang ??= updateLangFactory(this.ctx, this));
     }
+    get updatePinConversations() {
+        return (this._cache.updatePinConversations ??= updatePinConversationsFactory(this.ctx, this));
+    }
     get updateProductCatalog() {
         return (this._cache.updateProductCatalog ??= updateProductCatalogFactory(this.ctx, this));
     }
@@ -1159,6 +1231,9 @@ export class API {
     get verifyCloudMedia() {
         return (this._cache.verifyCloudMedia ??= verifyCloudMediaFactory(this.ctx, this));
     }
+    get verifyFriend() {
+        return (this._cache.verifyFriend ??= verifyFriendFactory(this.ctx, this));
+    }
     get voiceToText() {
         return (this._cache.voiceToText ??= voiceToTextFactory(this.ctx, this));
     }

package/dist/cjs/apis/auth/exportSession.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var utils = require('../../utils.cjs');
+
+const exportSessionFactory = utils.apiFactory()((_api, ctx) => {
+    /**
+     * Xuất toàn bộ thông tin phiên đăng nhập hiện tại (`uid`, `imei`, `userAgent`, `language`, `cookie`)
+     * dưới định dạng chuẩn `Credentials` để lưu trữ (JSON/Database) và truyền trực tiếp vào `zalo.login(session)`.
+     */
+    return function exportSession() {
+        const serializedJar = ctx.cookie?.toJSON();
+        return {
+            uid: ctx.uid,
+            imei: ctx.imei,
+            userAgent: ctx.userAgent,
+            language: ctx.language || "vi",
+            cookie: serializedJar?.cookies ?? [],
+        };
+    };
+});
+
+exports.exportSessionFactory = exportSessionFactory;

package/dist/cjs/apis/chat/getDirectMessageStatus.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+var wsCipher = require('../../crypto/ws-cipher.cjs');
+
+const getDirectMessageStatusFactory = utils.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.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.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(wsCipher.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: [] };
+        });
+    };
+});
+
+exports.getDirectMessageStatusFactory = getDirectMessageStatusFactory;

package/dist/cjs/apis/chat/getSuggestedConversations.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const getSuggestedConversationsFactory = utils.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.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getSuggestedConversationsFactory = getSuggestedConversationsFactory;

package/dist/cjs/apis/chat/updatePinConversations.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const updatePinConversationsFactory = utils.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.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.ZaloApiError("Failed to encrypt params");
+        }
+        const response = await utils.request(targetURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.updatePinConversationsFactory = updatePinConversationsFactory;

package/dist/cjs/apis/friend/getFriendProfilesV2.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const getFriendProfilesV2Factory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getprofiles/v2`);
+    /**
+     * Lấy hàng loạt hồ sơ chi tiết của danh sách bạn bè kèm trạng thái online qua `/api/social/friend/getprofiles/v2` (command 11140)
+     *
+     * @param friendIds Mảng UID cần lấy hồ sơ (có thể kèm hậu tố `_version` hoặc truyền UID thuần)
+     * @param options Tùy chọn truy vấn
+     * @throws {ZaloApiError}
+     */
+    return async function getFriendProfilesV2(friendIds, options = {}) {
+        const rawIds = Array.isArray(friendIds) ? friendIds : [friendIds];
+        if (rawIds.length === 0) {
+            throw new ZaloApiError.ZaloApiError("Missing friendIds");
+        }
+        const friendPversionMap = rawIds.map((id) => (id.includes("_") ? id : `${id}_0`));
+        const params = {
+            phonebook_version: options.phonebookVersion ?? 0,
+            friend_pversion_map: friendPversionMap,
+            avatar_size: options.avatarSize ?? 120,
+            language: options.language ?? ctx.language ?? "vi",
+            show_online_status: options.showOnlineStatus !== false ? 1 : 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(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getFriendProfilesV2Factory = getFriendProfilesV2Factory;

package/dist/cjs/apis/friend/getFriendsActivePCWeb.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var utils = require('../../utils.cjs');
+
+const getFriendsActivePCWebFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/active-pcweb`);
+    /**
+     * Lấy danh sách bạn bè đang hoạt động trên Zalo PC / Web qua `/api/social/friend/active-pcweb` (command 12072)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getFriendsActivePCWeb() {
+        const response = await utils.request(serviceURL, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.getFriendsActivePCWebFactory = getFriendsActivePCWebFactory;

package/dist/cjs/apis/friend/verifyFriend.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const verifyFriendFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/verify`);
+    /**
+     * Kiểm tra và xác thực danh sách bạn bè qua `/api/social/friend/verify` (command 11138)
+     *
+     * @param friendIds Danh sách UID bạn bè cần xác thực
+     * @param options Tùy chọn truy vấn
+     * @throws {ZaloApiError}
+     */
+    return async function verifyFriend(friendIds, options = {}) {
+        const rawIds = Array.isArray(friendIds) ? friendIds : [friendIds];
+        if (rawIds.length === 0) {
+            throw new ZaloApiError.ZaloApiError("Missing friendIds");
+        }
+        const friendPversionMap = rawIds.map((id) => (id.includes("_") ? id : `${id}_0`));
+        const params = {
+            phonebook_version: options.phonebookVersion ?? 0,
+            friend_pversion_map: friendPversionMap,
+            avatar_size: options.avatarSize ?? 120,
+            language: options.language ?? ctx.language ?? "vi",
+            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(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.verifyFriendFactory = verifyFriendFactory;

package/dist/cjs/apis/group/analyseGroup.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const analyseGroupFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/analyse`);
+    /**
+     * Lấy dữ liệu phân tích/thống kê của nhóm qua `/api/group/analyse` (command 12407)
+     *
+     * @param groupId ID của nhóm
+     * @throws {ZaloApiError}
+     */
+    return async function analyseGroup(groupId) {
+        if (!groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        const cleanGroupId = groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const params = {
+            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.analyseGroupFactory = analyseGroupFactory;

package/dist/cjs/apis/group/checkQuotaCommunityMember.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const checkQuotaCommunityMemberFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/quota/members-comm`);
+    /**
+     * Kiểm tra điều kiện/hạn mức thành viên Cộng đồng đối với một thành viên cụ thể trong nhóm (command 12182)
+     *
+     * @param groupId ID của nhóm
+     * @param uid UID của thành viên cần kiểm tra
+     * @throws {ZaloApiError}
+     */
+    return async function checkQuotaCommunityMember(groupId, uid) {
+        if (!groupId) {
+            throw new ZaloApiError.ZaloApiError("Missing groupId");
+        }
+        if (!uid) {
+            throw new ZaloApiError.ZaloApiError("Missing uid");
+        }
+        const cleanGroupId = groupId.startsWith("g") ? groupId.slice(1) : groupId;
+        const params = {
+            language: ctx.language || "vi",
+            grId: cleanGroupId,
+            uid: String(uid),
+        };
+        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.checkQuotaCommunityMemberFactory = checkQuotaCommunityMemberFactory;