@softtynet/zca-js 2.3.2 → 2.3.4

package/README.md

@@ -2,10 +2,22 @@
 
 <p align="left">
   <a href="https://www.npmjs.com/package/@softtynet/zca-js"><img src="https://img.shields.io/npm/v/@softtynet/zca-js.svg?label=%40softtynet%2Fzca-js&color=0068ff" alt="npm version" /></a>
+  <a href="https://softtyos.github.io/zca-js-docs/"><img src="https://img.shields.io/badge/Docs-VitePress-646cff.svg" alt="Documentation" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT" /></a>
 </p>
 
-**`@softtynet/zca-js`** là bộ thư viện client hỗ trợ kết nối và tương tác Zalo dành cho Node.js, TypeScript và Bun, được duy trì nội bộ bởi **Softtynet Co., Ltd.**
+**`@softtynet/zca-js`** là bộ thư viện SDK kết nối và tương tác Zalo dành cho **Node.js**, **TypeScript** và **Bun**, được phát triển và duy trì bởi **Softtynet Co., Ltd.** dựa trên phân tích giao thức Zalo PC `26.7.10`.
+
+- **Trang tài liệu chính thức (Documentation)**: [**https://softtyos.github.io/zca-js-docs/**](https://softtyos.github.io/zca-js-docs/)
+
+---
+
+## Điểm nổi bật
+
+- **Kiến trúc 12 Domains (`224 API nguyên bản`)**: Tổ chức trực quan qua `api.auth`, `api.chat`, `api.group`, `api.friend`, `api.profile`, `api.sync`, `api.zcloud`, `api.call`, `api.media`, `api.sticker`, `api.board`, `api.business` (vẫn hỗ trợ gọi phẳng `api.<method>` tương thích ngược 100%).
+- **Đồng bộ lịch sử Mobile (`ZDB 4.0`) & Catch-up Sync**: Hỗ trợ đầy đủ luồng `requestSyncFromPhone` $\rightarrow$ `getSyncData` (giải mã RSA-2048 OAEP/PKCS1 + ZDB 4.0 64KB multi-chunk AES-256-CBC + Deflate) & `pullMobile`.
+- **ZCloud, MediaStore & Bảo toàn Số nguyên 64-bit (`preParseJsonIds`)**: Tự động giữ nguyên độ chính xác chuỗi 19 chữ số cho `owner_id`, `group_id`, `globalMsgId`, `cliMsgId` trước khi `JSON.parse()` và tích hợp bộ mã hóa `98yS` AES-256-CBC cho ZCloud/ZFamily.
+- **Tín hiệu Gọi Thoại & Video Call 1-1**: Điều khiển trọn vẹn vòng đời cuộc gọi (`11300` $\rightarrow$ `11306`: `sendVoiceCall`, `cancelVoiceCall`, `endVoiceCall`) và lắng nghe `call_event` thời gian thực.
 
 ---
 
@@ -19,8 +31,6 @@ bun add @softtynet/zca-js
 
 ### Cấu hình `imageMetadataGetter` (Tùy chọn khi gửi ảnh từ file nội bộ)
 
-Nếu ứng dụng cần gửi ảnh hoặc GIF từ đường dẫn file trên máy, bạn có thể truyền hàm `imageMetadataGetter` (ví dụ sử dụng `sharp`):
-
 ```ts
 import { Zalo } from "@softtynet/zca-js";
 import sharp from "sharp";
@@ -41,6 +51,27 @@ const zalo = new Zalo({ imageMetadataGetter });
 
 ---
 
+## Kiến trúc 12 Phân hệ (Domains)
+
+| Phân hệ | Namespace | Số lượng API | Tài liệu chi tiết |
+| :--- | :--- | :---: | :--- |
+| **Xác thực & Phiên** | `api.auth` | 8 | [`docs/api/auth.md`](docs/api/auth.md) |
+| **Tin nhắn & Hội thoại** | `api.chat` | 35 | [`docs/api/chat.md`](docs/api/chat.md) |
+| **Nhóm & Cộng đồng** | `api.group` | 48 | [`docs/api/group.md`](docs/api/group.md) |
+| **Bạn bè & Danh bạ** | `api.friend` | 26 | [`docs/api/friend.md`](docs/api/friend.md) |
+| **Hồ sơ cá nhân** | `api.profile` | 18 | [`docs/api/profile.md`](docs/api/profile.md) |
+| **Đồng bộ Mobile ZDB 4.0** | `api.sync` | 5 | [`docs/api/sync.md`](docs/api/sync.md) |
+| **Đám mây ZCloud & ZFamily** | `api.zcloud` | 9 | [`docs/api/zcloud.md`](docs/api/zcloud.md) |
+| **Gọi thoại & Video 1-1** | `api.call` | 3 | [`docs/api/call.md`](docs/api/call.md) |
+| **Kho lưu trữ & Voice-to-Text** | `api.media` | 7 | [`docs/api/media.md`](docs/api/media.md) |
+| **Nhãn dán & Biểu cảm** | `api.sticker` | 8 | [`docs/api/sticker.md`](docs/api/sticker.md) |
+| **Bảng tin, Bình chọn & Lịch hẹn** | `api.board` | 16 | [`docs/api/board.md`](docs/api/board.md) |
+| **Zalo Business & Danh mục** | `api.business` | 41 | [`docs/api/business.md`](docs/api/business.md) |
+
+> Xem tổng quan toàn bộ tài liệu tại [`docs/api/index.md`](docs/api/index.md) hoặc chạy trang tài liệu VitePress cục bộ bằng lệnh `npm run docs:dev`.
+
+---
+
 ## Sử dụng cơ bản
 
 ### 1. Đăng nhập bằng mã QR
@@ -53,7 +84,7 @@ const api = await zalo.loginQR();
 console.log("Đã đăng nhập:", api.getOwnId());
 ```
 
-### 2. Lắng nghe tin nhắn
+### 2. Lắng nghe sự kiện WebSocket thời gian thực
 
 ```ts
 import { Zalo, ThreadType } from "@softtynet/zca-js";
@@ -74,25 +105,36 @@ api.listener.on("message", (message) => {
 api.listener.start({ retryOnClose: true });
 ```
 
-### 3. Gửi tin nhắn văn bản & Sticker
+### 3. Gọi API theo Domain Namespace
 
 ```ts
-// Trả lời tin nhắn văn bản
-await api.sendMessage(
-    {
-        msg: "Xin chào!",
-        quote: message.data,
-    },
-    message.threadId,
-    message.type,
-);
-
-// Tìm và gửi Sticker
-const stickerIds = await api.getStickers("xin chào");
-if (stickerIds.length > 0) {
-    const stickerObject = await api.getStickersDetail(stickerIds[0]);
-    await api.sendMessageSticker(stickerObject, message.threadId, message.type);
-}
+// Nhóm & Lịch sử tin nhắn Cloud
+const groupInfo = await api.group.getGroupInfo("888999000");
+const history = await api.group.getGroupChatHistory("888999000", { count: 50, cursor: 0 });
+const msgStatus = await api.group.getGroupMessageStatus("888999000", ["1000000000000000001"]);
+
+// Kho lưu trữ Media / File / Link
+const mediaPreview = await api.media.getMediaStorePreview("888999000", 50);
+const mediaList = await api.media.getConversationMedia({
+    groupId: "888999000",
+    mediaType: "media",
+    limit: 50,
+});
+
+// Giải mã thông tin thành viên hàng loạt
+const profiles = await api.group.getGroupMembersInfo(["1000000000000000001"]);
+```
+
+---
+
+## Chạy trang Tài liệu (VitePress Docs)
+
+```bash
+# Khởi chạy máy chủ tài liệu VitePress cục bộ (http://localhost:5173)
+npm run docs:dev
+
+# Sinh lại tài liệu từ mã nguồn src/apis/* và đóng gói tĩnh
+npm run docs:build
 ```
 
 ---

package/dist/apis/auth/exportSession.d.ts

@@ -0,0 +1,7 @@
+import type toughCookie from "tough-cookie";
+import type { Credentials } from "../../zalo.js";
+export type ExportedSession = Credentials & {
+    uid: string;
+    cookie: toughCookie.SerializedCookie[];
+};
+export declare const exportSessionFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => ExportedSession;

package/dist/apis/auth/exportSession.js

@@ -0,0 +1,17 @@
+import { apiFactory } from "../../utils.js";
+export const exportSessionFactory = 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 ?? [],
+        };
+    };
+});

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>;

package/dist/apis/friend/getFriendProfilesV2.js

@@ -0,0 +1,38 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const getFriendProfilesV2Factory = 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("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("Failed to encrypt params");
+        }
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

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

@@ -0,0 +1,6 @@
+export type GetFriendsActivePCWebResponse = {
+    uids?: string[];
+    activeUsers?: unknown[];
+    [key: string]: unknown;
+};
+export declare const getFriendsActivePCWebFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => Promise<GetFriendsActivePCWebResponse>;

package/dist/apis/friend/getFriendsActivePCWeb.js

@@ -0,0 +1,15 @@
+import { apiFactory } from "../../utils.js";
+export const getFriendsActivePCWebFactory = 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);
+    };
+});

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

@@ -0,0 +1,11 @@
+export type VerifyFriendOptions = {
+    phonebookVersion?: number;
+    avatarSize?: number;
+    language?: string;
+};
+export type VerifyFriendResponse = {
+    profiles?: Record<string, unknown>;
+    unchangeds_profile?: string[];
+    [key: string]: unknown;
+};
+export declare const verifyFriendFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (friendIds: string | string[], options?: VerifyFriendOptions) => Promise<VerifyFriendResponse>;

package/dist/apis/friend/verifyFriend.js

@@ -0,0 +1,37 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const verifyFriendFactory = 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("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("Failed to encrypt params");
+        }
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/group/analyseGroup.d.ts

@@ -0,0 +1,4 @@
+export type AnalyseGroupResponse = {
+    [key: string]: unknown;
+};
+export declare const analyseGroupFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (groupId: string) => Promise<AnalyseGroupResponse>;

package/dist/apis/group/analyseGroup.js

@@ -0,0 +1,28 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const analyseGroupFactory = 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("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("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/group/checkQuotaCommunityMember.d.ts

@@ -0,0 +1,6 @@
+export type CheckQuotaCommunityMemberResponse = {
+    status?: number;
+    canUpgrade?: boolean | number;
+    [key: string]: unknown;
+};
+export declare const checkQuotaCommunityMemberFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (groupId: string, uid: string) => Promise<CheckQuotaCommunityMemberResponse>;

package/dist/apis/group/checkQuotaCommunityMember.js

@@ -0,0 +1,34 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const checkQuotaCommunityMemberFactory = 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("Missing groupId");
+        }
+        if (!uid) {
+            throw new 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("Failed to encrypt params");
+        }
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/group/getE2eeGroupList.d.ts

@@ -0,0 +1,7 @@
+export type GetE2eeGroupListResponse = {
+    version?: number;
+    gridVerMap?: Record<string, string>;
+    e2eeGroups?: string[];
+    [key: string]: unknown;
+};
+export declare const getE2eeGroupListFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => Promise<GetE2eeGroupListResponse>;

package/dist/apis/group/getE2eeGroupList.js

@@ -0,0 +1,15 @@
+import { apiFactory } from "../../utils.js";
+export const getE2eeGroupListFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/getlg/e2ee`);
+    /**
+     * Lấy danh sách các nhóm đang bật mã hóa đầu cuối E2EE (command 12146)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getE2eeGroupList() {
+        const response = await utils.request(serviceURL, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/group/getGroupChatHistory.d.ts

@@ -1,18 +1,49 @@
 import { GroupMessage } from "../../models/index.js";
+export type GetGroupChatHistoryOptions = {
+    /**
+     * Số lượng tin nhắn cần tải (mặc định: `50`).
+     */
+    count?: number;
+    /**
+     * Con trỏ `globalMsgId` (`lastMsgId` của trang trước) để phân trang lùi sâu về quá khứ (mặc định: `0`).
+     */
+    cursor?: number | string;
+    /**
+     * Số trang tối đa được phép gọi trong một lần thực thi.
+     */
+    maxPages?: number;
+    /**
+     * Sử dụng endpoint `/api/cm/getoldv2` (command 12507) thay vì `/api/cm/getrecentv2` (command 12506).
+     */
+    useOldEndpoint?: boolean;
+    /**
+     * Danh sách `msgIds` cục bộ bổ sung (mặc định: `[]`).
+     */
+    msgIds?: Array<string | number>;
+    /**
+     * Nguồn truy vấn (mặc định: `3`).
+     */
+    src?: number;
+    /**
+     * Cờ hội thoại OA (tùy chọn).
+     */
+    isOA?: boolean;
+};
 export type GetGroupChatHistoryResponse = {
     error?: number;
-    lastMsgId?: number;
-    minMsgId?: number;
-    maxMsgId?: number;
-    msgJumpId?: number;
+    lastMsgId?: number | string;
+    nextCursor?: number | string;
+    minMsgId?: number | string;
+    maxMsgId?: number | string;
+    msgJumpId?: number | string;
     hasMore?: boolean;
     isOld?: boolean;
     isFiltered?: boolean;
-    rootMsgId?: number;
+    rootMsgId?: number | string;
     isRootDel?: boolean;
     groupMsgs: GroupMessage[];
     tsJoinGroup?: number;
     isFilteredByPhase?: boolean;
     isFilteredByTimeJoin?: boolean;
 };
-export declare const getGroupChatHistoryFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (groupId: string, count?: number) => Promise<GetGroupChatHistoryResponse>;
+export declare const getGroupChatHistoryFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (groupId: string, countOrOptions?: number | GetGroupChatHistoryOptions) => Promise<GetGroupChatHistoryResponse>;