@softtynet/zca-js 2.2.7 → 2.2.9

package/dist/cjs/apis/getStickerCategoryData.cjs

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

package/dist/cjs/apis/getStickerHello.cjs

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

package/dist/cjs/apis/getStickerSuggestKeywords.cjs

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

package/dist/cjs/apis/getStickerSuggestion.cjs

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

package/dist/cjs/apis/getUsageMyCloud.cjs

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

package/dist/cjs/apis/getUsageZCloud.cjs

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

package/dist/cjs/apis/keepAlive.cjs

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

package/dist/cjs/apis/listen.cjs

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

package/dist/cjs/apis/readContactTab.cjs

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

package/dist/cjs/apis/removeConversationMedia.cjs

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

package/dist/cjs/apis/undoMultiMessage.cjs

@@ -0,0 +1,62 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+require('../models/AutoReply.cjs');
+require('../models/Bank.cjs');
+require('../models/Board.cjs');
+var Enum = require('../models/Enum.cjs');
+require('../models/FriendEvent.cjs');
+require('../models/Group.cjs');
+require('../models/GroupEvent.cjs');
+require('../models/Reaction.cjs');
+require('../models/Reminder.cjs');
+require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
+var utils = require('../utils.cjs');
+
+const undoMultiMessageFactory = utils.apiFactory()((api, _ctx, utils) => {
+    /**
+     * Thu hồi hàng loạt nhiều tin nhắn cùng lúc trong hội thoại cá nhân hoặc nhóm (command 12115 / 12116)
+     *
+     * @param msgs Danh sách tin nhắn cần thu hồi (`globalMsgId`, `cliMsgId` của tin nhắn gốc)
+     * @param threadId ID người nhận hoặc ID nhóm
+     * @param type Loại hội thoại (`ThreadType.User` hoặc `ThreadType.Group`)
+     * @throws {ZaloApiError}
+     */
+    return async function undoMultiMessage(msgs, threadId, type = Enum.ThreadType.User) {
+        if (!Array.isArray(msgs) || msgs.length === 0) {
+            throw new ZaloApiError.ZaloApiError("Missing messages to undo");
+        }
+        if (!threadId) {
+            throw new ZaloApiError.ZaloApiError("Missing threadId");
+        }
+        const isGroup = type === Enum.ThreadType.Group || threadId.startsWith("g");
+        const cleanThreadId = threadId.startsWith("g") ? threadId.slice(1) : threadId;
+        const serviceURL = isGroup
+            ? utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/multi_undomsg`)
+            : utils.makeURL(`${api.zpwServiceMap.chat[0]}/api/message/multi_undo`);
+        const now = Date.now();
+        const normalizedMsgs = msgs.map((m, idx) => ({
+            cliMsgId: m.cliMsgIdUndo !== undefined ? m.cliMsgId : now + idx,
+            cliMsgIdUndo: m.cliMsgIdUndo !== undefined ? m.cliMsgIdUndo : m.cliMsgId,
+            globalMsgId: String(m.globalMsgId),
+        }));
+        const payload = isGroup
+            ? { grid: cleanThreadId, msgs: normalizedMsgs }
+            : { toid: cleanThreadId, msgs: normalizedMsgs };
+        const encryptedParams = utils.encodeAES(JSON.stringify(payload));
+        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.undoMultiMessageFactory = undoMultiMessageFactory;

package/dist/cjs/apis/updateRecentSearch.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const updateRecentSearchFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.recent_search[0]}/api/recentsearch/update`);
+    /**
+     * Cập nhật danh sách lịch sử tìm kiếm gần đây trên Zalo (command 12126)
+     *
+     * @param options Danh sách tìm kiếm gần đây và từ khóa (`listRecent`, `listKeyword`, `version`)
+     * @throws {ZaloApiError}
+     */
+    return async function updateRecentSearch(options = {}) {
+        var _a, _b, _c;
+        let currentVersion = options.version;
+        if (currentVersion === undefined) {
+            try {
+                const current = await api.getRecentSearchList(0);
+                currentVersion = (_a = current === null || current === void 0 ? void 0 : current.version) !== null && _a !== void 0 ? _a : 0;
+            }
+            catch (_d) {
+                currentVersion = 0;
+            }
+        }
+        const params = {
+            list_recent: (_b = options.listRecent) !== null && _b !== void 0 ? _b : [],
+            version: currentVersion,
+            list_keyword: (_c = options.listKeyword) !== null && _c !== void 0 ? _c : [],
+            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.updateRecentSearchFactory = updateRecentSearchFactory;

package/dist/cjs/apis/verifyCloudMedia.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const verifyCloudMediaFactory = utils.apiFactory()((api, _ctx, utils$1) => {
+    var _a;
+    const baseDomain = ((_a = api.zpwServiceMap.zcloud) === null || _a === void 0 ? void 0 : _a[0]) || "https://zcld.chat.zalo.me";
+    const serviceURL = utils$1.makeURL(`${baseDomain}/cloudmedia/queue/pc/verify`);
+    /**
+     * Kiểm tra và lấy danh sách mục Media lưu trữ trên ZCloud (command 12740 / 12761)
+     *
+     * @param options Tùy chọn truy vấn (`lastNoiseId`, `loadType`, `listNoiseIds`, `trackingSource`)
+     * @param viewerKeyInfo (Tùy chọn) Cặp `{ viewer_key, enk }` từ `api.getCloudViewerKey()`.
+     * @throws {ZaloApiError}
+     */
+    return async function verifyCloudMedia(options = {}, viewerKeyInfo) {
+        var _a, _b, _c, _d;
+        const keyInfo = viewerKeyInfo !== null && viewerKeyInfo !== void 0 ? viewerKeyInfo : (await api.getCloudViewerKey());
+        if (!(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.viewer_key) || !(keyInfo === null || keyInfo === void 0 ? void 0 : keyInfo.enk)) {
+            throw new ZaloApiError.ZaloApiError("Invalid CloudViewerKey");
+        }
+        const payload = {
+            lastNoiseId: (_a = options.lastNoiseId) !== null && _a !== void 0 ? _a : "",
+            loadType: (_b = options.loadType) !== null && _b !== void 0 ? _b : 0,
+            listNoiseIds: (_c = options.listNoiseIds) !== null && _c !== void 0 ? _c : [],
+            tracking_source: (_d = options.trackingSource) !== null && _d !== void 0 ? _d : 0,
+        };
+        const encryptedParams = utils.encryptZCloudAES(JSON.stringify(payload), keyInfo.enk);
+        const response = await utils$1.request(utils$1.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+            headers: {
+                "cloud-viewer-key": keyInfo.viewer_key,
+            },
+        });
+        const json = (await response.json());
+        if (json.error_code !== 0 && json.error_code !== -904) {
+            throw new ZaloApiError.ZaloApiError(json.error_message || "verifyCloudMedia failed", json.error_code);
+        }
+        if (!json.data) {
+            throw new ZaloApiError.ZaloApiError("Empty verifyCloudMedia response", json.error_code);
+        }
+        const decrypted = utils.decryptZCloudAES(json.data, keyInfo.enk);
+        return JSON.parse(decrypted);
+    };
+});
+
+exports.verifyCloudMediaFactory = verifyCloudMediaFactory;

package/dist/cjs/apis/voiceToText.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const voiceToTextFactory = utils.apiFactory()((api, _ctx, utils) => {
+    var _a;
+    const baseDomain = ((_a = api.zpwServiceMap.ai_features) === null || _a === void 0 ? void 0 : _a[0]) || "https://tt-ai-features-wpa.chat.zalo.me";
+    const serviceURL = utils.makeURL(`${baseDomain}/api/aifeatures/voice2text`);
+    /**
+     * Gửi yêu cầu chuyển đổi tin nhắn thoại sang văn bản bằng Zalo AI (command 13394).
+     * Kết quả văn bản sau khi xử lý xong sẽ được đẩy về qua sự kiện `api.listener.on("voice2text_event", ...)` khớp với `req_id`.
+     *
+     * @param voiceUrl Đường dẫn URL của tệp ghi âm tin nhắn thoại (`.aac` / `.mp3` / `.m4a`)
+     * @throws {ZaloApiError}
+     */
+    return async function voiceToText(voiceUrl) {
+        if (!voiceUrl) {
+            throw new ZaloApiError.ZaloApiError("Missing voiceUrl");
+        }
+        const encryptedParams = utils.encodeAES(JSON.stringify({ url: voiceUrl }));
+        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.voiceToTextFactory = voiceToTextFactory;