@softtynet/zca-js 2.1.16 → 2.1.18

package/README.md

@@ -18,6 +18,7 @@
 -   [Basic Usages](#basic-usages)
     -   [Login](#login)
     -   [Listen for new messages](#listen-for-new-messages)
+    -   [Synchronize Messages from Mobile](#synchronize-messages-from-mobile)
     -   [Send a message](#send-a-message)
     -   [Get/Send a sticker](#getsend-a-sticker)
 -   [Example](#example)
@@ -114,6 +115,44 @@ api.listener.start();
 > [!IMPORTANT]
 > Only one web listener can run per account at a time. If you open Zalo in the browser while the listener is active, the listener will be automatically stopped.
 
+### Synchronize Messages from Mobile
+
+`zca-js` supports cross-device message synchronization from the official Zalo mobile app:
+
+#### Case 1: Auto-Sync on QR Login
+When logging in via `loginQR`, check the **"Sync message with your phone"** checkbox on your phone before confirming:
+
+```javascript
+import { Zalo, LoginQRCallbackEventType } from "zca-js";
+
+const zalo = new Zalo({ selfListen: true });
+const api = await zalo.loginQR({ qrPath: "./qr.png" });
+
+// Listen for historical messages pushed from phone
+api.listener.on("old_messages", (messages, type) => {
+    console.log(`Received ${messages.length} historical synced messages!`);
+});
+
+api.listener.start();
+```
+
+#### Case 2: Manual Trigger Sync (from existing session)
+To request message synchronization from your phone at any time:
+
+```javascript
+api.listener.on("connected", async () => {
+    // Send sync request signal to mobile phone
+    await api.requestSyncFromPhone();
+    console.log("Please tap 'Sync now' on your phone!");
+});
+
+api.listener.on("old_messages", (messages, type) => {
+    console.log(`Received ${messages.length} synced messages from phone!`);
+});
+
+api.listener.start();
+```
+
 ### Send a message
 
 ```javascript

package/dist/apis/decryptGids.d.ts

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

package/dist/apis/decryptGids.js

@@ -0,0 +1,28 @@
+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
+     *
+     * @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 = {
+            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/downloadTransferSync.d.ts

@@ -0,0 +1,6 @@
+export type DownloadTransferSyncOptions = string | {
+    key: string;
+    exp: number | string;
+    sig: string;
+};
+export declare const downloadTransferSyncFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (options: DownloadTransferSyncOptions) => Promise<Buffer>;

package/dist/apis/downloadTransferSync.js

@@ -0,0 +1,30 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const downloadTransferSyncFactory = apiFactory()((api, ctx, utils) => {
+    /**
+     * Tải khối dữ liệu snapshot đồng bộ tin nhắn từ máy chủ transfersync.zaloapp.com
+     *
+     * @param options URL đầy đủ hoặc object chứa { key, exp, sig }
+     * @throws {ZaloApiError}
+     */
+    return async function downloadTransferSync(options) {
+        let downloadUrl = "";
+        if (typeof options === "string") {
+            downloadUrl = options;
+        }
+        else {
+            if (!options.key || !options.exp || !options.sig) {
+                throw new ZaloApiError("Missing key, exp or sig in options");
+            }
+            downloadUrl = `https://transfersync.zaloapp.com/api/transfer-sync-v2/download?key=${options.key}&exp=${options.exp}&sig=${options.sig}`;
+        }
+        const response = await utils.request(downloadUrl, {
+            method: "GET",
+        });
+        if (!response.ok) {
+            throw new ZaloApiError(`Failed to download transfer snapshot: ${response.statusText} (${response.status})`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    };
+});

package/dist/apis/getGroupChatHistory.d.ts

@@ -1,8 +1,18 @@
 import { GroupMessage } from "../models/index.js";
 export type GetGroupChatHistoryResponse = {
-    lastActionId: string;
-    lastActionIdOther: string;
-    more: number;
+    error?: number;
+    lastMsgId?: number;
+    minMsgId?: number;
+    maxMsgId?: number;
+    msgJumpId?: number;
+    hasMore?: boolean;
+    isOld?: boolean;
+    isFiltered?: boolean;
+    rootMsgId?: number;
+    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>;

package/dist/apis/getGroupChatHistory.js

@@ -2,35 +2,63 @@ import { ZaloApiError } from "../Errors/ZaloApiError.js";
 import { apiFactory } from "../utils.js";
 import { GroupMessage } from "../models/index.js";
 export const getGroupChatHistoryFactory = apiFactory()((api, ctx, utils) => {
-    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/history`);
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group_cloud_message[0]}/api/cm/getrecentv2`);
     /**
-     * Get group chat history
+     * Get group chat history from Zalo Cloud Message (newest first)
      *
      * @param groupId group id
-     * @param count count of messages to return (default: 50)
+     * @param count count of messages to return (default: 50, max safe limit: 200)
      *
      * @throws {ZaloApiError}
      */
     return async function getGroupChatHistory(groupId, count = 50) {
-        const params = {
-            grid: groupId,
-            count: count,
-        };
-        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, (result) => {
-            let data = result.data;
-            if (typeof data === "string") {
-                data = JSON.parse(data);
+        if (!groupId)
+            throw new ZaloApiError("Missing groupId");
+        if (groupId.startsWith("g"))
+            groupId = groupId.slice(1);
+        const safeCount = Math.min(Math.max(count, 1), 200);
+        const messages = [];
+        let cursor = 0;
+        let lastPage = null;
+        let pageCount = 0;
+        while (messages.length < safeCount && pageCount < 10) {
+            pageCount++;
+            const params = {
+                groupId,
+                globalMsgId: cursor,
+                count: Math.min(50, safeCount - messages.length),
+                msgIds: [],
+                imei: ctx.imei,
+                src: 3,
+            };
+            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, nretry: 0 }), {
+                method: "GET",
+            });
+            lastPage = await utils.resolve(response, (result) => {
+                let data = result.data;
+                if (typeof data === "string") {
+                    data = JSON.parse(data);
+                }
+                return data;
+            });
+            if (!lastPage || !Array.isArray(lastPage.groupMsgs))
+                break;
+            for (const rawMsg of lastPage.groupMsgs) {
+                if (messages.length >= safeCount)
+                    break;
+                if (messages.some((m) => m.msgId === rawMsg.msgId))
+                    continue;
+                messages.push(rawMsg);
             }
-            for (let i = 0; i < data.groupMsgs.length; i++) {
-                data.groupMsgs[i] = new GroupMessage(ctx.uid, data.groupMsgs[i]);
-            }
-            return data;
-        });
+            const nextCursor = Number(lastPage.lastMsgId);
+            if (!lastPage.hasMore || !nextCursor || nextCursor === cursor)
+                break;
+            cursor = nextCursor;
+        }
+        const groupMsgs = messages.map((data) => new GroupMessage(ctx.uid, data));
+        return Object.assign({}, lastPage || {}, { groupMsgs });
     };
 });

package/dist/apis/listen.d.ts

@@ -28,6 +28,7 @@ export declare enum CloseReason {
 interface ListenerEvents {
     connected: [];
     disconnected: [code: CloseReason, reason: string];
+    reconnecting: [code: CloseReason];
     closed: [code: CloseReason, reason: string];
     error: [error: unknown];
     typing: [typing: Typing];
@@ -62,6 +63,8 @@ export declare class Listener extends EventEmitter<ListenerEvents> {
     private selfListen;
     private pingInterval?;
     private retryTimeout?;
+    private watchdogTimeout?;
+    private consecutive1006Count;
     private id;
     constructor(ctx: ContextSession, urls: string[]);
     /**
@@ -80,7 +83,10 @@ export declare class Listener extends EventEmitter<ListenerEvents> {
      * @deprecated Use `on` method instead
      */
     onMessage(cb: OnMessageCallback): void;
+    private isRetryable;
     private canRetry;
+    private resetRetryCount;
+    private resetWatchdog;
     private shouldRotate;
     private rotateEndpoint;
     start({ retryOnClose }?: {

package/dist/apis/listen.js

@@ -3,7 +3,7 @@ import WebSocket from "ws";
 import { initializeFriendEvent } from "../models/FriendEvent.js";
 import { initializeGroupEvent } from "../models/GroupEvent.js";
 import { GroupMessage, UserMessage, Reaction, Undo, ThreadType, GroupTyping, UserTyping } from "../models/index.js";
-import { decodeEventData, getFriendEventType, getGroupEventType, hasOwn, logger, makeURL } from "../utils.js";
+import { decodeEventData, getBrowserLanguage, getFriendEventType, getGroupEventType, hasOwn, logger, makeURL } from "../utils.js";
 import { ZaloApiError } from "../Errors/ZaloApiError.js";
 import { GroupSeenMessage, UserSeenMessage } from "../models/SeenMessage.js";
 import { UserDeliveredMessage, GroupDeliveredMessage } from "../models/DeliveredMessage.js";
@@ -19,6 +19,7 @@ export class Listener extends EventEmitter {
         super();
         this.ctx = ctx;
         this.urls = urls;
+        this.consecutive1006Count = 0;
         this.id = 0;
         if (!ctx.cookie)
             throw new ZaloApiError("Cookie is not available");
@@ -70,26 +71,71 @@ export class Listener extends EventEmitter {
     onMessage(cb) {
         this.onMessageCallback = cb;
     }
+    isRetryable(code) {
+        return (code === CloseReason.AbnormalClosure ||
+            this.ctx.settings.features.socket.close_and_retry_codes.includes(code));
+    }
     canRetry(code) {
-        if (!this.ctx.settings.features.socket.close_and_retry_codes.includes(code))
+        var _a;
+        if (!this.isRetryable(code))
             return false;
-        if (this.retryCount[code.toString()].count >= this.retryCount[code.toString()].max)
+        const retry = (_a = this.retryCount[code.toString()]) !== null && _a !== void 0 ? _a : this.retryCount["internal"];
+        if (!retry || retry.count >= retry.max)
             return false;
-        this.retryCount[code.toString()].count++;
-        const { count, max, times } = this.retryCount[code.toString()];
-        const retryTime = count - 1 < times.length ? times[count - 1] : times[times.length - 1];
+        retry.count++;
+        const { count, max, times } = retry;
+        let retryTime;
+        if (count - 1 < times.length) {
+            retryTime = times[count - 1];
+        }
+        else {
+            const lastTime = times[times.length - 1] || 1000;
+            const multiplier = Math.min(Math.pow(1.5, count - times.length), 10);
+            const jitter = Math.floor(Math.random() * 1000);
+            retryTime = Math.min(Math.floor(lastTime * multiplier) + jitter, 30000);
+        }
         logger(this.ctx).verbose(`Retry for code ${code} in ${retryTime}ms (${count}/${max})`);
         return retryTime;
     }
+    resetRetryCount() {
+        for (const retry of Object.values(this.retryCount)) {
+            retry.count = 0;
+        }
+    }
+    resetWatchdog() {
+        if (this.watchdogTimeout)
+            clearTimeout(this.watchdogTimeout);
+        this.watchdogTimeout = setTimeout(() => {
+            logger(this.ctx).verbose("Watchdog timeout: no packet/pong received from Zalo WebSocket in 50s. Forcing reconnect...");
+            if (this.ws) {
+                try {
+                    if (typeof this.ws.terminate === "function") {
+                        this.ws.terminate();
+                    }
+                    else if (typeof this.ws.close === "function") {
+                        this.ws.close(CloseReason.AbnormalClosure);
+                    }
+                }
+                catch (_a) {
+                    // Ignore if already terminated
+                }
+            }
+        }, 50000);
+    }
     shouldRotate(code) {
-        if (!this.ctx.settings.features.socket.rotate_error_codes.includes(code))
-            return false;
-        if (this.rotateCount >= this.urls.length - 1)
+        if (code === CloseReason.AbnormalClosure) {
+            this.consecutive1006Count++;
+            if (this.consecutive1006Count >= 2) {
+                this.consecutive1006Count = 0;
+                return true;
+            }
             return false;
-        return true;
+        }
+        this.consecutive1006Count = 0;
+        return this.ctx.settings.features.socket.rotate_error_codes.includes(code);
     }
     rotateEndpoint() {
-        this.rotateCount++;
+        this.rotateCount = (this.rotateCount + 1) % this.urls.length;
         this.wsURL = makeURL(this.ctx, this.urls[this.rotateCount], {
             t: Date.now(),
         });
@@ -98,37 +144,46 @@ export class Listener extends EventEmitter {
     start({ retryOnClose = false } = {}) {
         if (this.ws)
             throw new ZaloApiError("Already started");
+        this.wsURL = makeURL(this.ctx, this.urls[this.rotateCount], {
+            t: Date.now(),
+        });
+        const cookie = this.ctx.cookie.getCookieStringSync("https://chat.zalo.me");
         const ws = new WebSocket(this.wsURL, {
             headers: {
-                "accept-encoding": "gzip, deflate, br, zstd",
-                "accept-language": "en-US,en;q=0.9",
+                "accept-language": getBrowserLanguage(this.ctx.language),
                 "cache-control": "no-cache",
                 connection: "Upgrade",
                 host: new URL(this.wsURL).host,
                 origin: "https://chat.zalo.me",
-                prgama: "no-cache",
+                pragma: "no-cache",
                 "sec-websocket-extensions": "permessage-deflate; client_max_window_bits",
                 "sec-websocket-version": "13",
                 upgrade: "websocket",
                 "user-agent": this.userAgent,
-                cookie: this.cookie,
+                cookie,
             },
-            agent: this.ctx.options.agent
+            agent: this.ctx.options.agent,
         });
         this.ws = ws;
         ws.onopen = () => {
+            this.consecutive1006Count = 0;
+            this.resetRetryCount();
+            this.resetWatchdog();
             this.onConnectedCallback();
             this.emit("connected");
         };
         ws.onclose = (event) => {
             this.reset();
             this.emit("disconnected", event.code, event.reason);
-            const retry = retryOnClose && this.canRetry(event.code);
+            const retry = retryOnClose &&
+                this.isRetryable(event.code) &&
+                this.canRetry(event.code);
             if (retry && retryOnClose) {
                 const shouldRotate = this.shouldRotate(event.code);
                 if (shouldRotate) {
                     this.rotateEndpoint();
                 }
+                this.emit("reconnecting", event.code);
                 this.retryTimeout = setTimeout(() => {
                     this.start({ retryOnClose: true });
                 }, retry);
@@ -143,6 +198,8 @@ export class Listener extends EventEmitter {
             this.emit("error", event);
         };
         ws.onmessage = async (event) => {
+            var _a, _b, _c;
+            this.resetWatchdog();
             this.emit("pong"); // Pulse event to notify watchdog that socket is alive
             const { data } = event;
             if (!(data instanceof Buffer))
@@ -170,9 +227,10 @@ export class Listener extends EventEmitter {
                         this.sendWs(payload, false);
                         this.emit("ping");
                     };
+                    const pingIntervalTime = Math.min(Math.max(((_c = (_b = (_a = this.ctx.settings) === null || _a === void 0 ? void 0 : _a.features) === null || _b === void 0 ? void 0 : _b.socket) === null || _c === void 0 ? void 0 : _c.ping_interval) || 25000, 10000), 25000);
                     this.pingInterval = setInterval(() => {
                         ping();
-                    }, this.ctx.settings.features.socket.ping_interval);
+                    }, pingIntervalTime);
                 }
                 if (version == 1 && cmd == 501 && subCmd == 0) {
                     const parsedData = (await decodeEventData(parsed, this.cipherKey)).data;
@@ -369,6 +427,8 @@ export class Listener extends EventEmitter {
     stop() {
         if (this.retryTimeout)
             clearTimeout(this.retryTimeout);
+        if (this.watchdogTimeout)
+            clearTimeout(this.watchdogTimeout);
         if (this.ws) {
             if (this.ws.readyState !== WebSocket.CLOSED) {
                 this.ws.close(CloseReason.ManualClosure);
@@ -425,6 +485,8 @@ export class Listener extends EventEmitter {
         this.cipherKey = undefined;
         if (this.pingInterval)
             clearInterval(this.pingInterval);
+        if (this.watchdogTimeout)
+            clearTimeout(this.watchdogTimeout);
     }
 }
 function getHeader(buffer) {

package/dist/apis/login.js

@@ -3,7 +3,7 @@ import { decryptResp, getSignKey, logger, makeURL, ParamsEncryptor, request } fr
 export async function login(ctx, encryptParams) {
     const encryptedParams = await getEncryptParam(ctx, encryptParams, "getlogininfo");
     try {
-        const response = await request(ctx, makeURL(ctx, "https://wpa.chat.zalo.me/api/login/getLoginInfo", Object.assign(Object.assign({}, encryptedParams.params), { nretry: 0 })));
+        const response = await request(ctx, makeURL(ctx, "https://wpa.chat.zalo.me/api/login/getLoginInfo", Object.assign(Object.assign({}, encryptedParams.params), { nretry: 0 }), false));
         if (!response.ok)
             throw new ZaloApiError("Failed to fetch login info: " + response.statusText);
         const data = await response.json();

package/dist/apis/loginQR.js

@@ -1,35 +1,20 @@
 import { CookieJar } from "tough-cookie";
 import { writeFile } from "node:fs/promises";
 import { ZaloApiError } from "../Errors/ZaloApiError.js";
-import { logger, request, getPlatformFromUA, getChromeVersionFromUA } from "../utils.js";
+import { logger, request, getBrowserLanguage, getSecChUaHeaders } from "../utils.js";
 import { ZaloApiLoginQRAborted } from "../Errors/ZaloApiLoginQRAborted.js";
 import { ZaloApiLoginQRDeclined } from "../Errors/ZaloApiLoginQRDeclined.js";
 /**
- * Tạo bộ header Sec-CH-UA dùng chung cho toàn bộ các request trong luồng đăng nhập QR.
+ * Tạo bộ header Sec-CH-UA và ngôn ngữ dùng chung cho toàn bộ các request trong luồng đăng nhập QR.
  *
- * Trước đây 8 hàm con trong loginQR đều copy-paste cùng một bộ header với giá trị
- * `sec-ch-ua-platform: "Windows"` bị hardcode cứng. Điều này gây ra mâu thuẫn fingerprint
- * (Browser Mismatch) khi người dùng truyền vào User-Agent của Mac hoặc Linux,
- * khiến hệ thống chống bot của Zalo phát hiện và ban session ngay lập tức.
+ * Tất cả giá trị sec-ch-ua-* đều được suy luận ĐỘNG từ ctx.userAgent (chỉ khi là Chromium)
+ * và accept-language theo ctx.language, đảm bảo nhất quán 100% với môi trường trình duyệt thật.
  *
- * Giải pháp: Tất cả giá trị sec-ch-ua-* đều được suy luận ĐỘNG từ ctx.userAgent,
- * đảm bảo nhất quán 100% giữa User-Agent và các Client Hint headers.
- *
- * @param ctx - Context chứa ctx.userAgent đã được gán trước khi gọi hàm này
+ * @param ctx - Context chứa ctx.userAgent và ctx.language
  * @param extra - Các header bổ sung đặc thù cho từng request (sec-fetch-dest, Referer...)
  */
 function getLoginHeaders(ctx, extra) {
-    // Suy luận platform từ UA: "Windows" | "macOS" | "Linux" (mặc định "Windows" nếu không nhận ra)
-    const platform = getPlatformFromUA(ctx.userAgent);
-    // Trích xuất phiên bản Chrome major từ UA (ví dụ: "130"), fallback về "130" nếu không phải Chrome
-    const chromeVer = getChromeVersionFromUA(ctx.userAgent);
-    return Object.assign({ "accept-language": "vi-VN,vi;q=0.9,fr-FR;q=0.8,fr;q=0.7,en-US;q=0.6,en;q=0.5", 
-        // sec-ch-ua phải khớp với phiên bản Chrome trong User-Agent
-        "sec-ch-ua": `"Chromium";v="${chromeVer}", "Google Chrome";v="${chromeVer}", "Not?A_Brand";v="99"`, 
-        // Luôn là desktop (?0) vì Zalo Web không hỗ trợ mobile
-        "sec-ch-ua-mobile": "?0", 
-        // sec-ch-ua-platform PHẢI nhất quán với User-Agent — đây là nguyên nhân gốc rễ gây ban session
-        "sec-ch-ua-platform": `"${platform}"` }, extra);
+    return Object.assign(Object.assign({ "accept-language": getBrowserLanguage(ctx.language) }, getSecChUaHeaders(ctx.userAgent)), extra);
 }
 export var LoginQRCallbackEventType;
 (function (LoginQRCallbackEventType) {

package/dist/apis/preloadConversations.d.ts

@@ -0,0 +1,10 @@
+export type PreloadConversationsResponse = {
+    conversations?: Array<{
+        conv_id: string;
+        last_msgs?: unknown[];
+        unread_count?: number;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+};
+export declare const preloadConversationsFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => () => Promise<PreloadConversationsResponse>;

package/dist/apis/preloadConversations.js

@@ -0,0 +1,23 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const preloadConversationsFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.conversation[0]}/api/preloadconvers/get-last-msgs`);
+    /**
+     * Preload last messages across all active conversations.
+     * Useful for initial state loading and catching up missed messages after reconnect.
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function preloadConversations() {
+        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/requestSyncFromPhone.d.ts

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

package/dist/apis/requestSyncFromPhone.js

@@ -0,0 +1,27 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const requestSyncFromPhoneFactory = apiFactory()((api, ctx) => {
+    /**
+     * Gửi tín hiệu kích hoạt yêu cầu đồng bộ tin nhắn từ xa sang app điện thoại (Trường hợp 2)
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function requestSyncFromPhone() {
+        if (!api.listener) {
+            throw new ZaloApiError("WebSocket listener is not initialized. Please call api.listener.start() first.");
+        }
+        // Gửi frame yêu cầu đồng bộ qua WebSocket
+        const syncPayload = {
+            version: 1,
+            cmd: 510,
+            subCmd: 0,
+            data: {
+                act: "sync_request",
+                imei: ctx.imei,
+                ts: Date.now(),
+            },
+        };
+        api.listener.sendWs(syncPayload, true);
+        return { success: true };
+    };
+});

package/dist/apis.d.ts

@@ -21,6 +21,7 @@ import { createNoteFactory } from "./apis/createNote.js";
 import { createPollFactory } from "./apis/createPoll.js";
 import { createProductCatalogFactory } from "./apis/createProductCatalog.js";
 import { createReminderFactory } from "./apis/createReminder.js";
+import { decryptGidsFactory } from "./apis/decryptGids.js";
 import { deleteAutoReplyFactory } from "./apis/deleteAutoReply.js";
 import { deleteAvatarFactory } from "./apis/deleteAvatar.js";
 import { deleteCatalogFactory } from "./apis/deleteCatalog.js";
@@ -30,6 +31,7 @@ import { deleteMessageFactory } from "./apis/deleteMessage.js";
 import { deleteProductCatalogFactory } from "./apis/deleteProductCatalog.js";
 import { disableGroupLinkFactory } from "./apis/disableGroupLink.js";
 import { disperseGroupFactory } from "./apis/disperseGroup.js";
+import { downloadTransferSyncFactory } from "./apis/downloadTransferSync.js";
 import { editNoteFactory } from "./apis/editNote.js";
 import { editReminderFactory } from "./apis/editReminder.js";
 import { enableGroupLinkFactory } from "./apis/enableGroupLink.js";
@@ -94,6 +96,7 @@ import { lastOnlineFactory } from "./apis/lastOnline.js";
 import { leaveGroupFactory } from "./apis/leaveGroup.js";
 import { lockPollFactory } from "./apis/lockPoll.js";
 import { parseLinkFactory } from "./apis/parseLink.js";
+import { preloadConversationsFactory } from "./apis/preloadConversations.js";
 import { rejectFriendRequestFactory } from "./apis/rejectFriendRequest.js";
 import { removeFriendFactory } from "./apis/removeFriend.js";
 import { removeFriendAliasFactory } from "./apis/removeFriendAlias.js";
@@ -103,6 +106,7 @@ import { removeQuickMessageFactory } from "./apis/removeQuickMessage.js";
 import { removeReminderFactory } from "./apis/removeReminder.js";
 import { removeUnreadMarkFactory } from "./apis/removeUnreadMark.js";
 import { removeUserFromGroupFactory } from "./apis/removeUserFromGroup.js";
+import { requestSyncFromPhoneFactory } from "./apis/requestSyncFromPhone.js";
 import { resetHiddenConversPinFactory } from "./apis/resetHiddenConversPin.js";
 import { reuseAvatarFactory } from "./apis/reuseAvatar.js";
 import { reviewPendingMemberRequestFactory } from "./apis/reviewPendingMemberRequest.js";
@@ -171,6 +175,7 @@ export declare class API {
     createPoll: ReturnType<typeof createPollFactory>;
     createProductCatalog: ReturnType<typeof createProductCatalogFactory>;
     createReminder: ReturnType<typeof createReminderFactory>;
+    decryptGids: ReturnType<typeof decryptGidsFactory>;
     deleteAutoReply: ReturnType<typeof deleteAutoReplyFactory>;
     deleteAvatar: ReturnType<typeof deleteAvatarFactory>;
     deleteCatalog: ReturnType<typeof deleteCatalogFactory>;
@@ -180,6 +185,7 @@ export declare class API {
     deleteProductCatalog: ReturnType<typeof deleteProductCatalogFactory>;
     disableGroupLink: ReturnType<typeof disableGroupLinkFactory>;
     disperseGroup: ReturnType<typeof disperseGroupFactory>;
+    downloadTransferSync: ReturnType<typeof downloadTransferSyncFactory>;
     editNote: ReturnType<typeof editNoteFactory>;
     editReminder: ReturnType<typeof editReminderFactory>;
     enableGroupLink: ReturnType<typeof enableGroupLinkFactory>;
@@ -244,6 +250,7 @@ export declare class API {
     leaveGroup: ReturnType<typeof leaveGroupFactory>;
     lockPoll: ReturnType<typeof lockPollFactory>;
     parseLink: ReturnType<typeof parseLinkFactory>;
+    preloadConversations: ReturnType<typeof preloadConversationsFactory>;
     rejectFriendRequest: ReturnType<typeof rejectFriendRequestFactory>;
     removeFriend: ReturnType<typeof removeFriendFactory>;
     removeFriendAlias: ReturnType<typeof removeFriendAliasFactory>;
@@ -253,6 +260,7 @@ export declare class API {
     removeReminder: ReturnType<typeof removeReminderFactory>;
     removeUnreadMark: ReturnType<typeof removeUnreadMarkFactory>;
     removeUserFromGroup: ReturnType<typeof removeUserFromGroupFactory>;
+    requestSyncFromPhone: ReturnType<typeof requestSyncFromPhoneFactory>;
     resetHiddenConversPin: ReturnType<typeof resetHiddenConversPinFactory>;
     reuseAvatar: ReturnType<typeof reuseAvatarFactory>;
     reviewPendingMemberRequest: ReturnType<typeof reviewPendingMemberRequestFactory>;