@softtynet/zca-js 2.2.9 → 2.3.1

package/README.md

@@ -1,52 +1,15 @@
-# @softtynet/zca-js — Softtynet Zalo API SDK for Node.js & Bun
+# @softtynet/zca-js
 
 <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://github.com/softtyos/zca-js"><img src="https://img.shields.io/badge/Maintained%20by-Softtynet%20Co.%2C%20Ltd.-0a7cff" alt="Maintained by Softtynet" /></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 Zalo API nâng cao dành cho Node.js / TypeScript / Bun, được phát triển, tối ưu hoá và duy trì bởi **Softtynet Co., Ltd.** nhằm đáp ứng các bài toán tích hợp chuyên sâu: **Đồng bộ dữ liệu đa thiết bị (Offline Catch-up & Mobile Backup Sync `ZDB4.0`)**, **Tín hiệu Gọi Thoại & Gọi Video (Voice / Video Call Signaling)**, và **Xử lý WebSocket thời gian thực độ tin cậy cao**.
-
-> [!WARNING]
-> Đây là thư viện tương tác không chính thức thông qua giao thức Zalo Web / Zalo PC dành cho tài khoản cá nhân. Vui lòng sử dụng có trách nhiệm và tuân thủ quy định an toàn tài khoản.
-
----
-
-## Mục lục
-
-- [Điểm nổi bật trên phiên bản Softtynet (`@softtynet/zca-js`)](#-điểm-nổi-bật-trên-phiên-bản-softtynet-softtynetzca-js)
-- [Cài đặt](#-cài-đặt)
-- [Tài liệu chuyên sâu](#-tài-liệu-chuyên-sâu)
-- [Hướng dẫn sử dụng nhanh](#-hướng-dẫn-sử-dụng-nhanh)
-  - [1. Đăng nhập & Lưu phiên](#1-đăng-nhập--lưu-phiên)
-  - [2. Lắng nghe tin nhắn thời gian thực](#2-lắng-nghe-tin-nhắn-thời-gian-thực)
-  - [3. Đồng bộ bù tin nhắn khi Offline (Catch-up Sync)](#3-đồng-bộ-bù-tin-nhắn-khi-offline-catch-up-sync)
-  - [4. Đồng bộ lịch sử sao lưu từ Điện thoại (`ZDB4.0`)](#4-đồng-bộ-lịch-sử-sao-lưu-từ-điện-thoại-zdb40)
-  - [5. Khởi tạo Cuộc gọi Thoại & Gọi Video](#5-khởi-tạo-cuộc-gọi-thoại--gọi-video)
-  - [6. Gửi tin nhắn & Sticker](#6-gửi-tin-nhắn--sticker)
-- [Kiểm định & Chạy thử nghiệm](#-kiểm-định--chạy-thử-nghiệm)
-- [Nguồn gốc & Ghi nhận (Credits & Attribution)](#-nguồn-gốc--ghi-nhận-credits--attribution)
-- [Giấy phép (License)](#-giấy-phép-license)
+**`@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.**
 
 ---
 
-## 🚀 Điểm nổi bật trên phiên bản Softtynet (`@softtynet/zca-js`)
-
-So với phiên bản cộng đồng tiêu chuẩn, **`@softtynet/zca-js`** bổ sung các phân hệ cốt lõi đã được kiểm định trực tiếp trên máy chủ Zalo thật:
-
-| Phân hệ | Tính năng trên `@softtynet/zca-js` |
-| :--- | :--- |
-| **Đồng bộ bù khi Offline (Catch-up Sync)** | Hỗ trợ [`api.preloadConversations()`](src/apis/preloadConversations.ts) (`cmd 10053`), kéo hàng đợi tin nhắn cá nhân & nhóm qua [`api.listener.requestOldMessages()`](src/apis/listen.ts) (`cmd 510` / `511`, cả `subCmd 0` & `1`), kèm cờ phân trang `hasMore`, tách biệt sự kiện thu hồi `undo` và đồng bộ trạng thái đã đọc `unread_cleared` (`cmd 504` / `524`). |
-| **Đồng bộ sao lưu từ Điện thoại (`ZDB4.0`)** | Hỗ trợ trọn vẹn chu trình [`api.requestSyncFromPhone()`](src/apis/requestSyncFromPhone.ts) (`cmd 12000`), [`api.cancelPullMobile()`](src/apis/cancelPullMobile.ts) (`cmd 12700`), sự kiện `sync_event` (`user_confirm`, `syncmsg_info`, `transfer_after_login`), tải gói `.db.crypt` qua [`api.getSyncData()`](src/apis/getSyncData.ts) và giải mã RSA-2048 PKCS#1 v1.5 + AES-256-CBC đa khối 64KB + đọc mục lục SQLite (`parseZdbHeader`). |
-| **Ánh xạ ID ẩn danh (Noised / Global ID)** | Hỗ trợ [`api.getNoisedIds()`](src/apis/getNoisedIds.ts) (`cmd 12390` kèm cơ chế tự động fallback sang `zwid.api.zalo.me`) và [`api.decryptGids()`](src/apis/decryptGids.ts) (`cmd 12054`) để ánh xạ tên file SQLite `3_<me>_<peer>.db` về User ID / Group ID thật. |
-| **Gọi Thoại & Gọi Video (Signaling 2 bước)** | Hỗ trợ [`api.sendVoiceCall()`](src/apis/sendVoiceCall.ts) (`cmd 11300` + `11301`), [`api.cancelVoiceCall()`](src/apis/cancelVoiceCall.ts) (`cmd 11305`), [`api.endVoiceCall()`](src/apis/endVoiceCall.ts) (`cmd 11306`) và sự kiện `call_event` chuẩn giao thức C++ `ZaloCall` cho cả **Gọi Thoại (`CallType.Audio = 1`)** lẫn **Gọi Video (`CallType.Video = 3`, H.264)**. |
-| **Hệ sinh thái ZCloud, ZFamily & AI (`26.7.10`)** | Hỗ trợ chuẩn mã hóa `98yS` (AES-256-CBC với 16-byte Random IV) cho ZCloud & ZFamily ([`getCloudViewerKey`](src/apis/getCloudViewerKey.ts), [`getUsageZCloud`](src/apis/getUsageZCloud.ts), [`getUsageMyCloud`](src/apis/getUsageMyCloud.ts), [`getCloudSettings`](src/apis/getCloudSettings.ts), [`getCloudInfo`](src/apis/getCloudInfo.ts), [`getFamilyUsage`](src/apis/getFamilyUsage.ts), [`verifyCloudMedia`](src/apis/verifyCloudMedia.ts), [`getFamilyViewerKey`](src/apis/getFamilyViewerKey.ts), [`getFamilyProfile`](src/apis/getFamilyProfile.ts)), AI chuyển giọng nói thành văn bản [`voiceToText`](src/apis/voiceToText.ts) (`cmd 13394` + `voice2text_event`), Emoji Status ([`getEmojiStatusConfig`](src/apis/getEmojiStatusConfig.ts), [`getFriendsEmojiStatus`](src/apis/getFriendsEmojiStatus.ts)), Kho Lưu Trữ Hội Thoại ([`getConversationMedia`](src/apis/getConversationMedia.ts), [`getMediaStorePreview`](src/apis/getMediaStorePreview.ts), [`removeConversationMedia`](src/apis/removeConversationMedia.ts)), Lịch sử tìm kiếm ([`getRecentSearchList`](src/apis/getRecentSearchList.ts), [`updateRecentSearch`](src/apis/updateRecentSearch.ts)) cùng 25+ API Nhóm, Hồ sơ, Danh bạ & Nhãn dán V2 đã kiểm định Live 100%. |
-| **Độ ổn định & Bảo vệ bộ nhớ** | Tự động giải phóng bộ nhớ `uploadCallbacks` sau 5 phút trong [`uploadAttachment`](src/apis/uploadAttachment.ts), xử lý phản hồi rỗng hợp lệ (`error_code === 0, data === ""`) và bảo toàn độ chính xác chuỗi UID 19 chữ số. |
-
----
-
-## 📦 Cài đặt
+## Cài đặt
 
 ```bash
 npm install @softtynet/zca-js
@@ -54,13 +17,9 @@ npm install @softtynet/zca-js
 bun add @softtynet/zca-js
 ```
 
-### Cấu hình `imageMetadataGetter` (Khi gửi ảnh từ đường dẫn file)
+### Cấu hình `imageMetadataGetter` (Tùy chọn khi gửi ảnh từ file nội bộ)
 
-Từ kiến trúc V2, thư viện tách rời phụ thuộc xử lý ảnh để giữ dung lượng gọn nhẹ. Nếu ứng dụng của bạn gửi ảnh/GIF từ file nội bộ, hãy truyền hàm `imageMetadataGetter` (ví dụ dùng `sharp`):
-
-```bash
-npm install sharp
-```
+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";
@@ -82,27 +41,19 @@ const zalo = new Zalo({ imageMetadataGetter });
 
 ---
 
-## 📚 Tài liệu chuyên sâu
-
-- **[Hướng dẫn Tích hợp: Đồng bộ Tin nhắn Đa Thiết bị (`ZDB4.0`) & Gọi Thoại / Video](docs/INTEGRATION_GUIDE_SYNC_AND_CALL.md)** — Tài liệu đầy đủ kèm sơ đồ kiến trúc và code mẫu tích hợp thực tế của Softtynet.
-- **[Kế hoạch & Hướng dẫn Dịch ngược Zalo bằng REA (`morluto/rea`)](docs/REA_REVERSE_ENGINEERING_PLAN.md)** — Tài liệu quy trình phân tích tĩnh Binary C++ (`ZaloCall`, `libzdatabase.dylib`) và ASAR.
-- **[API Reference Cơ bản](https://zca-js.tdung.com)** — Tra cứu danh mục các API cơ bản.
-
----
-
-## ⚡ Hướng dẫn sử dụng nhanh
+## Sử dụng cơ bản
 
-### 1. Đăng nhập & Lưu phiên
+### 1. Đăng nhập bằng mã QR
 
 ```ts
 import { Zalo } from "@softtynet/zca-js";
 
 const zalo = new Zalo({ selfListen: true });
 const api = await zalo.loginQR();
-console.log("Đã đăng nhập với UID:", api.getOwnId());
+console.log("Đã đăng nhập:", api.getOwnId());
 ```
 
-### 2. Lắng nghe tin nhắn thời gian thực
+### 2. Lắng nghe tin nhắn
 
 ```ts
 import { Zalo, ThreadType } from "@softtynet/zca-js";
@@ -111,117 +62,25 @@ const zalo = new Zalo({ selfListen: true });
 const api = await zalo.loginQR();
 
 api.listener.on("message", (message) => {
-    const isPlainText = typeof message.data.content === "string";
-    if (!isPlainText) return;
+    if (typeof message.data.content !== "string") return;
 
     if (message.type === ThreadType.User) {
-        console.log(`[Cá nhân] ${message.data.dName}: ${message.data.content}`);
+        console.log(`[User] ${message.data.dName}: ${message.data.content}`);
     } else if (message.type === ThreadType.Group) {
-        console.log(`[Nhóm ${message.threadId}] ${message.data.dName}: ${message.data.content}`);
+        console.log(`[Group ${message.threadId}] ${message.data.dName}: ${message.data.content}`);
     }
 });
 
 api.listener.start({ retryOnClose: true });
 ```
 
-> [!IMPORTANT]
-> Mỗi tài khoản Zalo chỉ duy trì một kết nối WebSocket Web tại một thời điểm. Nếu bạn mở thêm tab Zalo Web trên trình duyệt, kết nối WebSocket cũ sẽ nhận sự kiện `duplicate_connection`.
-
-### 3. Đồng bộ bù tin nhắn khi Offline (Catch-up Sync)
-
-```ts
-import { ThreadType } from "@softtynet/zca-js";
-
-// 1. Lấy nhanh các tin nhắn mới nhất & danh sách đã đọc qua HTTP (cmd 10053)
-const preload = await api.preloadConversations();
-console.log(`Preloaded: ${preload.messages.length} tin nhắn, ${preload.unreadCleared.length} trạng thái đã đọc`);
-
-// 2. Nhận tin nhắn từ hàng đợi WebSocket (cmd 510 & 511)
-api.listener.on("old_messages", (messages, type, hasMore) => {
-    console.log(`Nhận ${messages.length} tin nhắn cũ (type=${type}, hasMore=${hasMore})`);
-    if (hasMore && messages.length > 0) {
-        const lastMsgId = messages[messages.length - 1].data.msgId;
-        api.listener.requestOldMessages(type, lastMsgId);
-    }
-});
-
-// 3. Kích hoạt kéo hàng đợi ngay khi nhận khoá giải mã WebSocket
-api.listener.on("cipher_key", () => {
-    api.listener.requestOldMessages(ThreadType.User);
-    api.listener.requestOldMessages(ThreadType.Group);
-});
-
-api.listener.start({ retryOnClose: true });
-```
-
-### 4. Đồng bộ lịch sử sao lưu từ Điện thoại (`ZDB4.0`)
-
-```ts
-import fs from "node:fs";
-import {
-    SyncEventType,
-    decryptWithPrivateKey,
-    deriveZdbAesKey,
-    decryptZdbBuffer,
-    parseZdbHeader,
-} from "@softtynet/zca-js";
-
-let privateKey = "";
-
-api.listener.on("sync_event", async (event) => {
-    if (event.type === SyncEventType.USER_CONFIRM) {
-        console.log("Người dùng đã bấm xác nhận trên điện thoại, đang chờ tải gói sao lưu...");
-    } else if (event.type === SyncEventType.SYNCMSG_INFO) {
-        const res = await api.getSyncData({ ...event.data, savePath: "./sync_data" });
-        if (res.success && res.data && privateKey) {
-            const rawRsa = decryptWithPrivateKey(privateKey, res.data.encrypted_key);
-            const aesKey = deriveZdbAesKey(rawRsa);
-            const zdbPlain = decryptZdbBuffer(fs.readFileSync(res.data.file_path), aesKey);
-            const toc = parseZdbHeader(zdbPlain);
-            console.log(`Giải mã thành công ZDB4.0 (${toc.entries.length} hội thoại SQLite):`, toc.entries.slice(0, 5));
-        }
-    }
-});
-
-api.listener.on("cipher_key", async () => {
-    const session = await api.requestSyncFromPhone({ pcName: "Web" });
-    privateKey = session.privateKey;
-    console.log("Vui lòng mở điện thoại và bấm 'Đồng bộ ngay' trên thông báo Zalo!");
-});
-```
-
-### 5. Khởi tạo Cuộc gọi Thoại & Gọi Video
-
-```ts
-import { CallType } from "@softtynet/zca-js";
-
-const targetUid = "5249661060655759359"; // Chuỗi UID 19 chữ số
-
-// Gọi Video (CallType.Video = 3, tự động đính kèm H.264 payload 97)
-const videoCall = await api.sendVoiceCall(targetUid, {
-    callType: CallType.Video,
-});
-console.log("Đang đổ chuông Video:", videoCall.callId, videoCall.rtpServer);
-
-// Huỷ cuộc gọi khi đang đổ chuông
-await api.cancelVoiceCall(targetUid, videoCall.callId, {
-    callType: CallType.Video,
-});
-
-// Hoặc gọi Thoại (CallType.Audio = 1)
-const audioCall = await api.sendVoiceCall(targetUid, {
-    callType: CallType.Audio,
-});
-await api.cancelVoiceCall(targetUid, audioCall.callId);
-```
-
-### 6. Gửi tin nhắn & Sticker
+### 3. Gửi tin nhắn văn bản & Sticker
 
 ```ts
 // Trả lời tin nhắn văn bản
 await api.sendMessage(
     {
-        msg: "Xin chào từ hệ thống Softtynet!",
+        msg: "Xin chào!",
         quote: message.data,
     },
     message.threadId,
@@ -238,38 +97,15 @@ if (stickerIds.length > 0) {
 
 ---
 
-## 🧪 Kiểm định & Chạy thử nghiệm
-
-Dự án đi kèm bộ kiểm định 2 lớp trong thư mục [`test/`](test):
+## Nguồn gốc & Ghi nhận (Credits)
 
-1. **Kiểm định tự động (Offline / Unit Verification Suite)**:
-   ```bash
-   npm run test:verify
-   ```
-   Kiểm tra tự động toàn bộ 6 hạng mục: `preloadConversations`, `requestSyncFromPhone` / `pullMobile` / `cancelPullMobile`, `getNoisedIds` / `decryptGids`, giải mã `RSA-2048` + `ZDB4.0` đa khối 64KB, `sendVoiceCall` (Audio & Video) / `cancelVoiceCall` / `endVoiceCall`, và các sự kiện WebSocket (`510`, `511`, `504`, `601`).
-
-2. **Kiểm định trực tiếp trên tài khoản Zalo thật (Live Verification Suite)**:
-   ```bash
-   # Chạy toàn bộ 6 bước (Quét QR -> Preload -> ZNoise -> OldMessages -> Đồng bộ ZDB4.0 từ ĐT -> Voice/Video Call)
-   npm run test:live
-
-   # Chỉ test nhanh Gọi Thoại + Gọi Video tới 1 UID bạn bè
-   npm run test:live -- --only-call --call <UID_BAN_BE>
-   ```
-
----
-
-## 🤝 Nguồn gốc & Ghi nhận (Credits & Attribution)
-
-Dự án **`@softtynet/zca-js`** được phát triển, nâng cấp và duy trì bởi **Softtynet Co., Ltd.** ([`softtyos/zca-js`](https://github.com/softtyos/zca-js)), kế thừa nền tảng mã nguồn mở từ dự án gốc:
+Phiên bản này được phát triển và duy trì bởi **Softtynet Co., Ltd.**, kế thừa nền tảng mã nguồn mở từ dự án gốc:
 
 - **Dự án gốc**: [RFS-ADRENO/zca-js](https://github.com/RFS-ADRENO/zca-js)
-- **Tác giả nền tảng gốc**: RFS-ADRENO, truong9c2208, JustKemForFun cùng các thành viên đóng góp từ cộng đồng mã nguồn mở.
-
-Chúng tôi trân trọng cảm ơn các tác giả của dự án gốc đã xây dựng nền tảng ban đầu cho cộng đồng JavaScript/TypeScript.
+- **Tác giả nền tảng ban đầu**: RFS-ADRENO, truong9c2208, JustKemForFun cùng các thành viên đóng góp từ cộng đồng mã nguồn mở.
 
 ---
 
-## 📄 Giấy phép (License)
+## Giấy phép (License)
 
 Phát hành theo giấy phép [MIT License](LICENSE).

package/dist/Errors/ZaloApiError.js

@@ -1,4 +1,5 @@
 export class ZaloApiError extends Error {
+    code;
     constructor(message, code) {
         super(message);
         this.name = "ZcaApiError";

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

@@ -0,0 +1,6 @@
+export type DecryptGidsResponse = {
+    data?: Record<string, string>;
+    gids?: Record<string, string>;
+    [key: string]: unknown;
+};
+export declare const decryptGidsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (gids: string | string[]) => Promise<DecryptGidsResponse>;

package/dist/apis/auth/decryptGids.js

@@ -0,0 +1,30 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const decryptGidsFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/gid/decrypt`);
+    /**
+     * Giải mã danh sách Global ID (g_...) ẩn danh thành User ID thật
+     * (tương ứng hàm `getUidFromGlobalNoiseId` / command `12054` trên Zalo PC)
+     *
+     * @param gids Danh sách Global ID (hoặc 1 GID đơn lẻ)
+     * @throws {ZaloApiError}
+     */
+    return async function decryptGids(gids) {
+        if (!gids)
+            throw new ZaloApiError("Missing gids");
+        if (!Array.isArray(gids))
+            gids = [gids];
+        const params = {
+            globalUids: JSON.stringify(gids),
+            gids,
+            imei: ctx.imei,
+        };
+        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/auth/encryptGids.d.ts

@@ -0,0 +1,4 @@
+export type EncryptGidsResponse = {
+    data: Record<string, string>;
+};
+export declare const encryptGidsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (uids: string[]) => Promise<EncryptGidsResponse>;

package/dist/apis/auth/encryptGids.js

@@ -0,0 +1,24 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const encryptGidsFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/gid/encrypt`);
+    /**
+     * Mã hóa danh sách UID thật sang định danh ẩn danh Global Noise ID (`OTDAKO...`) (command 12053)
+     *
+     * @param uids Mảng chuỗi các UID cần mã hóa
+     * @throws {ZaloApiError}
+     */
+    return async function encryptGids(uids) {
+        if (!Array.isArray(uids) || uids.length === 0) {
+            return { data: {} };
+        }
+        const encryptedParams = utils.encodeAES(JSON.stringify({ noiseUids: uids }));
+        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/auth/getContext.d.ts

@@ -0,0 +1 @@
+export declare const getContextFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => import("../../context.js").ContextSession;

package/dist/apis/auth/getContext.js

@@ -0,0 +1,4 @@
+import { apiFactory } from "../../utils.js";
+export const getContextFactory = apiFactory()((_, ctx) => {
+    return () => ctx;
+});

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

@@ -0,0 +1 @@
+export declare const getCookieFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => import("tough-cookie").CookieJar;

package/dist/apis/auth/getCookie.js

@@ -0,0 +1,9 @@
+import { apiFactory } from "../../utils.js";
+export const getCookieFactory = apiFactory()((_, ctx) => {
+    /**
+     * Get the current cookie string
+     */
+    return function getCookie() {
+        return ctx.cookie;
+    };
+});

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

@@ -0,0 +1,10 @@
+export type GetListDeviceResponse = {
+    devices: {
+        masterId: string;
+        encIdentity: string;
+        lastUpdateTs: number;
+        encSignature: string;
+        companions: unknown[];
+    };
+};
+export declare const getListDeviceFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => Promise<GetListDeviceResponse>;

package/dist/apis/auth/getListDevice.js

@@ -0,0 +1,22 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const getListDeviceFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.aext[0]}/api/devices/linked`);
+    /**
+     * Get list device
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getListDevice() {
+        const params = {
+            imei: ctx.imei,
+        };
+        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/auth/getNoisedIds.d.ts

@@ -0,0 +1,9 @@
+export type GetNoisedIdsParams = {
+    fids?: Array<string | number>;
+    gids?: Array<string | number>;
+};
+export type GetNoisedIdsResponse = {
+    fids: string[];
+    gids: string[];
+};
+export declare const getNoisedIdsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => ({ fids, gids }: GetNoisedIdsParams) => Promise<GetNoisedIdsResponse>;

package/dist/apis/auth/getNoisedIds.js

@@ -0,0 +1,67 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory, ZALO_DOMAINS, ZALO_ENDPOINTS } from "../../utils.js";
+const ZWID_ZNOISE_URL = `${ZALO_DOMAINS.ZWID_API}${ZALO_ENDPOINTS.ZWID.ZNOISE}`;
+function toNumericIds(ids) {
+    return ids.map((id) => Number.parseInt(String(id), 10));
+}
+function normalizeNoised(list, expected, stripGroupPrefix) {
+    const out = [];
+    const arr = Array.isArray(list) ? list : [];
+    for (let i = 0; i < expected; i++) {
+        let v = arr[i] == null ? "" : String(arr[i]);
+        if (stripGroupPrefix && v.startsWith("g"))
+            v = v.slice(1);
+        out.push(v === "0" ? "" : v);
+    }
+    return out;
+}
+export const getNoisedIdsFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/znoise`);
+    /**
+     * Chuyển đổi danh sách UID cá nhân (`fids`) và GID nhóm (`gids`) dạng số thuần (từ SQLite ZDB4.0 mobile)
+     * sang định dạng Noised ID 19 chữ số dùng trên Zalo Web/PC (`getNoisedUids`, command `12390`).
+     * Tự động fallback sang `https://zwid.api.zalo.me/api/znoise` nếu profile domain trả về lỗi.
+     *
+     * @param params Danh sách `fids` và `gids`
+     * @throws {ZaloApiError}
+     */
+    return async function getNoisedIds({ fids = [], gids = [] }) {
+        const payload = {
+            fids: toNumericIds(fids),
+            gids: toNumericIds(gids),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(payload));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt params");
+        try {
+            const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+                method: "GET",
+            });
+            const data = await utils.resolve(response);
+            const raw = (data ?? {});
+            return {
+                fids: normalizeNoised(raw.fids, fids.length, false),
+                gids: normalizeNoised(raw.gids, gids.length, true),
+            };
+        }
+        catch (primaryErr) {
+            try {
+                const body = new URLSearchParams({ params: encryptedParams }).toString();
+                const fallbackUrl = utils.makeURL(ZWID_ZNOISE_URL);
+                const response = await utils.request(fallbackUrl, {
+                    method: "POST",
+                    body,
+                });
+                const data = await utils.resolve(response);
+                const raw = (data ?? {});
+                return {
+                    fids: normalizeNoised(raw.fids, fids.length, false),
+                    gids: normalizeNoised(raw.gids, gids.length, true),
+                };
+            }
+            catch {
+                throw primaryErr;
+            }
+        }
+    };
+});

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

@@ -0,0 +1 @@
+export declare const getOwnIdFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => string;

package/dist/apis/auth/getOwnId.js

@@ -0,0 +1,4 @@
+import { apiFactory } from "../../utils.js";
+export const getOwnIdFactory = apiFactory()((_, ctx) => {
+    return () => ctx.uid;
+});

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

@@ -0,0 +1,4 @@
+export type GetQRResponse = {
+    [userId: string]: string;
+};
+export declare const getQRFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (userId: string | string[]) => Promise<GetQRResponse>;

package/dist/apis/auth/getQR.js

@@ -0,0 +1,29 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const getQRFactory = apiFactory()((api, _, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.friend[0]}/api/friend/mget-qr`);
+    /**
+     * Get QR code for users
+     *
+     * @param userId User ID or list of user IDs
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function getQR(userId) {
+        if (typeof userId == "string")
+            userId = [userId];
+        const params = {
+            fids: userId,
+        };
+        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/auth/keepAlive.d.ts

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

package/dist/apis/auth/keepAlive.js

@@ -0,0 +1,24 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const keepAliveFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.chat[0]}/keepalive`);
+    /**
+     * 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}
+     */
+    return async function keepAlive() {
+        const params = {
+            imei: ctx.imei,
+        };
+        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/auth/lostFocus.d.ts

@@ -0,0 +1,4 @@
+export type LostFocusResponse = {
+    status: boolean;
+};
+export declare const lostFocusFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => () => Promise<LostFocusResponse>;

package/dist/apis/auth/lostFocus.js

@@ -0,0 +1,23 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const lostFocusFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/profile/changefgtobg`);
+    /**
+     * Lost focus
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function lostFocus() {
+        const params = {};
+        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/auth/scanURL.d.ts

@@ -0,0 +1,4 @@
+export type ScanURLResponse = {
+    isSafe: boolean;
+};
+export declare const scanURLFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (url: string) => Promise<ScanURLResponse>;

package/dist/apis/auth/scanURL.js

@@ -0,0 +1,28 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const scanURLFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/scanurl`);
+    /**
+     * Scan URL to check if it is safe?
+     *
+     * @param url URL to scan
+     *
+     * @throws {ZaloApiError} When something went wrong, with `error.code`
+     * - `114` - Invalid params
+     */
+    return async function scanURL(url) {
+        const params = {
+            url: url,
+        };
+        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/auth/updateActiveStatus.d.ts

@@ -0,0 +1,4 @@
+export type UpdateActiveStatusResponse = {
+    status: boolean;
+};
+export declare const updateActiveStatusFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (active: boolean) => Promise<UpdateActiveStatusResponse>;