@softtynet/zca-js 2.1.16 → 2.1.18

package/dist/cjs/utils.cjs

@@ -267,25 +267,49 @@ function getPlatformFromUA(userAgent) {
  */
 function getChromeVersionFromUA(userAgent) {
     if (!userAgent)
-        return "130"; // Không có UA → dùng version ổn định
+        return "133"; // Không có UA → dùng version ổn định hiện đại
     const match = userAgent.match(/Chrome\/(\d+)/);
-    return match ? match[1] : "130"; // Không phải Chrome → fallback về "130"
+    return match ? match[1] : "133"; // Không phải Chrome → fallback về "133"
+}
+/**
+ * Chuẩn hóa chuỗi Accept-Language dựa theo thiết lập ngôn ngữ ngữ cảnh.
+ *
+ * @param language Mã ngôn ngữ ("vi", "en", ...)
+ * @returns Chuỗi Accept-Language chuẩn theo hành vi trình duyệt
+ */
+function getBrowserLanguage(language) {
+    if (language === "en") {
+        return "en-US,en;q=0.9,vi;q=0.8";
+    }
+    return "vi-VN,vi;q=0.9,en-US;q=0.8,en;q=0.7";
+}
+/**
+ * Sinh bộ header Sec-CH-UA nhất quán theo User-Agent (chỉ khi là Chromium/Chrome).
+ *
+ * Nếu User-Agent là Firefox/Safari, hàm sẽ trả về object rỗng nhằm tránh
+ * tạo ra dị thường Browser Mismatch.
+ *
+ * @param userAgent Chuỗi User-Agent của client
+ * @returns Record chứa các header sec-ch-ua-* hoặc object rỗng
+ */
+function getSecChUaHeaders(userAgent) {
+    if (!userAgent || !/Chrome\//i.test(userAgent))
+        return {};
+    const platform = getPlatformFromUA(userAgent);
+    const chromeVer = getChromeVersionFromUA(userAgent);
+    return {
+        "sec-ch-ua": `"Not=A?Brand";v="99", "Google Chrome";v="${chromeVer}", "Chromium";v="${chromeVer}"`,
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": `"${platform}"`,
+    };
 }
 async function getDefaultHeaders(ctx, origin = "https://chat.zalo.me") {
     if (!ctx.cookie)
         throw new ZaloApiError.ZaloApiError("Cookie is not available");
     if (!ctx.userAgent)
         throw new ZaloApiError.ZaloApiError("User agent is not available");
-    return {
-        Accept: "application/json, text/plain, */*",
-        "Accept-Encoding": "gzip, deflate, br, zstd",
-        "Accept-Language": "en-US,en;q=0.9",
-        "content-type": "application/x-www-form-urlencoded",
-        Cookie: await ctx.cookie.getCookieString(origin),
-        Origin: "https://chat.zalo.me",
-        Referer: "https://chat.zalo.me/",
-        "User-Agent": ctx.userAgent,
-    };
+    const secChUa = getSecChUaHeaders(ctx.userAgent);
+    return Object.assign({ accept: "*/*", "accept-encoding": "gzip, deflate, br, zstd", "accept-language": getBrowserLanguage(ctx.language), "content-type": "application/x-www-form-urlencoded", cookie: await ctx.cookie.getCookieString(origin), origin: "https://chat.zalo.me", priority: "u=1, i", referer: "https://chat.zalo.me/", "user-agent": ctx.userAgent, "sec-fetch-dest": "empty", "sec-fetch-mode": "cors", "sec-fetch-site": "same-site" }, secChUa);
 }
 async function request(ctx, url, options, raw = false) {
     var _a, _b;
@@ -300,11 +324,17 @@ async function request(ctx, url, options, raw = false) {
         else
             options = { headers: defaultHeaders };
     }
-    const _options = Object.assign(Object.assign({}, (options !== null && options !== void 0 ? options : {})), (isBun ? {
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        proxy: (_b = (_a = ctx.options.agent) === null || _a === void 0 ? void 0 : _a.proxy) === null || _b === void 0 ? void 0 : _b.href
-    } : { agent: ctx.options.agent }));
+    const _options = Object.assign(Object.assign({}, (options !== null && options !== void 0 ? options : {})), (isBun
+        ? {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            proxy: (_b = (_a = ctx.options.agent) === null || _a === void 0 ? void 0 : _a.proxy) === null || _b === void 0 ? void 0 : _b.href,
+        }
+        : {
+            agent: ctx.options.agent,
+            // Hỗ trợ Undici Dispatcher cho Node.js 18+ native fetch
+            dispatcher: ctx.options.agent,
+        }));
     const response = await ctx.options.polyfill(url, _options);
     const setCookieRaw = response.headers.get("set-cookie");
     if (setCookieRaw && !raw) {
@@ -712,6 +742,7 @@ exports.encodeAES = encodeAES;
 exports.encryptPin = encryptPin;
 exports.formatTime = formatTime;
 exports.generateZaloUUID = generateZaloUUID;
+exports.getBrowserLanguage = getBrowserLanguage;
 exports.getChromeVersionFromUA = getChromeVersionFromUA;
 exports.getClientMessageType = getClientMessageType;
 exports.getDefaultHeaders = getDefaultHeaders;
@@ -725,6 +756,7 @@ exports.getGroupEventType = getGroupEventType;
 exports.getImageMetaData = getImageMetaData;
 exports.getMd5LargeFileObject = getMd5LargeFileObject;
 exports.getPlatformFromUA = getPlatformFromUA;
+exports.getSecChUaHeaders = getSecChUaHeaders;
 exports.getSignKey = getSignKey;
 exports.handleZaloResponse = handleZaloResponse;
 exports.hasOwn = hasOwn;

package/dist/cjs/zalo.cjs

@@ -78,7 +78,8 @@ class Zalo {
         if (!options)
             options = {};
         if (!options.userAgent)
-            options.userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:133.0) Gecko/20100101 Firefox/133.0";
+            options.userAgent =
+                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36";
         if (!options.language)
             options.language = "vi";
         const ctx = context.createContext(this.options.apiType, this.options.apiVersion);

package/dist/context.js

@@ -10,7 +10,7 @@ class CallbacksMap extends Map {
         return super.set(key, value);
     }
 }
-export const createContext = (apiType = 30, apiVersion = 671) => ({
+export const createContext = (apiType = 30, apiVersion = 689) => ({
     API_TYPE: apiType,
     API_VERSION: apiVersion,
     uploadCallbacks: new CallbacksMap(),

package/dist/index.d.ts

@@ -31,6 +31,8 @@ export type { DeleteChatLastMessage, DeleteChatResponse } from "./apis/deleteCha
 export type { DeleteGroupInviteBoxResponse } from "./apis/deleteGroupInviteBox.js";
 export type { DeleteMessageDestination, DeleteMessageResponse } from "./apis/deleteMessage.js";
 export type { DeleteProductCatalogPayload, DeleteProductCatalogResponse } from "./apis/deleteProductCatalog.js";
+export type { DecryptGidsResponse } from "./apis/decryptGids.js";
+export type { DownloadTransferSyncOptions } from "./apis/downloadTransferSync.js";
 export type { DisableGroupLinkResponse } from "./apis/disableGroupLink.js";
 export type { DisperseGroupResponse } from "./apis/disperseGroup.js";
 export type { EditNoteOptions, EditNoteResponse } from "./apis/editNote.js";
@@ -103,6 +105,7 @@ export type { RemoveQuickMessageResponse } from "./apis/removeQuickMessage.js";
 export type { RemoveReminderResponse } from "./apis/removeReminder.js";
 export type { RemoveUnreadMarkResponse } from "./apis/removeUnreadMark.js";
 export type { RemoveUserFromGroupResponse } from "./apis/removeUserFromGroup.js";
+export type { RequestSyncFromPhoneResponse } from "./apis/requestSyncFromPhone.js";
 export type { ResetHiddenConversPinResponse } from "./apis/resetHiddenConversPin.js";
 export type { ReuseAvatarResponse } from "./apis/reuseAvatar.js";
 export type { ReviewPendingMemberRequestPayload, ReviewPendingMemberRequestResponse } from "./apis/reviewPendingMemberRequest.js";

package/dist/utils.d.ts

@@ -81,15 +81,36 @@ export declare function getPlatformFromUA(userAgent: string | undefined): string
  * @returns Phiên bản Chrome major dạng string, ví dụ: "130", "133"
  */
 export declare function getChromeVersionFromUA(userAgent: string | undefined): string;
+/**
+ * Chuẩn hóa chuỗi Accept-Language dựa theo thiết lập ngôn ngữ ngữ cảnh.
+ *
+ * @param language Mã ngôn ngữ ("vi", "en", ...)
+ * @returns Chuỗi Accept-Language chuẩn theo hành vi trình duyệt
+ */
+export declare function getBrowserLanguage(language: string | undefined): string;
+/**
+ * Sinh bộ header Sec-CH-UA nhất quán theo User-Agent (chỉ khi là Chromium/Chrome).
+ *
+ * Nếu User-Agent là Firefox/Safari, hàm sẽ trả về object rỗng nhằm tránh
+ * tạo ra dị thường Browser Mismatch.
+ *
+ * @param userAgent Chuỗi User-Agent của client
+ * @returns Record chứa các header sec-ch-ua-* hoặc object rỗng
+ */
+export declare function getSecChUaHeaders(userAgent: string | undefined): Record<string, string>;
 export declare function getDefaultHeaders(ctx: ContextBase, origin?: string): Promise<{
-    Accept: string;
-    "Accept-Encoding": string;
-    "Accept-Language": string;
+    accept: string;
+    "accept-encoding": string;
+    "accept-language": string;
     "content-type": string;
-    Cookie: string;
-    Origin: string;
-    Referer: string;
-    "User-Agent": string;
+    cookie: string;
+    origin: string;
+    priority: string;
+    referer: string;
+    "user-agent": string;
+    "sec-fetch-dest": string;
+    "sec-fetch-mode": string;
+    "sec-fetch-site": string;
 }>;
 export declare function request(ctx: ContextBase, url: string, options?: RequestInit, raw?: boolean): Promise<Response>;
 export declare function getImageMetaData(ctx: ContextBase, filePath: string): Promise<{

package/dist/utils.js

@@ -263,25 +263,49 @@ export function getPlatformFromUA(userAgent) {
  */
 export function getChromeVersionFromUA(userAgent) {
     if (!userAgent)
-        return "130"; // Không có UA → dùng version ổn định
+        return "133"; // Không có UA → dùng version ổn định hiện đại
     const match = userAgent.match(/Chrome\/(\d+)/);
-    return match ? match[1] : "130"; // Không phải Chrome → fallback về "130"
+    return match ? match[1] : "133"; // Không phải Chrome → fallback về "133"
+}
+/**
+ * Chuẩn hóa chuỗi Accept-Language dựa theo thiết lập ngôn ngữ ngữ cảnh.
+ *
+ * @param language Mã ngôn ngữ ("vi", "en", ...)
+ * @returns Chuỗi Accept-Language chuẩn theo hành vi trình duyệt
+ */
+export function getBrowserLanguage(language) {
+    if (language === "en") {
+        return "en-US,en;q=0.9,vi;q=0.8";
+    }
+    return "vi-VN,vi;q=0.9,en-US;q=0.8,en;q=0.7";
+}
+/**
+ * Sinh bộ header Sec-CH-UA nhất quán theo User-Agent (chỉ khi là Chromium/Chrome).
+ *
+ * Nếu User-Agent là Firefox/Safari, hàm sẽ trả về object rỗng nhằm tránh
+ * tạo ra dị thường Browser Mismatch.
+ *
+ * @param userAgent Chuỗi User-Agent của client
+ * @returns Record chứa các header sec-ch-ua-* hoặc object rỗng
+ */
+export function getSecChUaHeaders(userAgent) {
+    if (!userAgent || !/Chrome\//i.test(userAgent))
+        return {};
+    const platform = getPlatformFromUA(userAgent);
+    const chromeVer = getChromeVersionFromUA(userAgent);
+    return {
+        "sec-ch-ua": `"Not=A?Brand";v="99", "Google Chrome";v="${chromeVer}", "Chromium";v="${chromeVer}"`,
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": `"${platform}"`,
+    };
 }
 export async function getDefaultHeaders(ctx, origin = "https://chat.zalo.me") {
     if (!ctx.cookie)
         throw new ZaloApiError("Cookie is not available");
     if (!ctx.userAgent)
         throw new ZaloApiError("User agent is not available");
-    return {
-        Accept: "application/json, text/plain, */*",
-        "Accept-Encoding": "gzip, deflate, br, zstd",
-        "Accept-Language": "en-US,en;q=0.9",
-        "content-type": "application/x-www-form-urlencoded",
-        Cookie: await ctx.cookie.getCookieString(origin),
-        Origin: "https://chat.zalo.me",
-        Referer: "https://chat.zalo.me/",
-        "User-Agent": ctx.userAgent,
-    };
+    const secChUa = getSecChUaHeaders(ctx.userAgent);
+    return Object.assign({ accept: "*/*", "accept-encoding": "gzip, deflate, br, zstd", "accept-language": getBrowserLanguage(ctx.language), "content-type": "application/x-www-form-urlencoded", cookie: await ctx.cookie.getCookieString(origin), origin: "https://chat.zalo.me", priority: "u=1, i", referer: "https://chat.zalo.me/", "user-agent": ctx.userAgent, "sec-fetch-dest": "empty", "sec-fetch-mode": "cors", "sec-fetch-site": "same-site" }, secChUa);
 }
 export async function request(ctx, url, options, raw = false) {
     var _a, _b;
@@ -296,11 +320,17 @@ export async function request(ctx, url, options, raw = false) {
         else
             options = { headers: defaultHeaders };
     }
-    const _options = Object.assign(Object.assign({}, (options !== null && options !== void 0 ? options : {})), (isBun ? {
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        proxy: (_b = (_a = ctx.options.agent) === null || _a === void 0 ? void 0 : _a.proxy) === null || _b === void 0 ? void 0 : _b.href
-    } : { agent: ctx.options.agent }));
+    const _options = Object.assign(Object.assign({}, (options !== null && options !== void 0 ? options : {})), (isBun
+        ? {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            proxy: (_b = (_a = ctx.options.agent) === null || _a === void 0 ? void 0 : _a.proxy) === null || _b === void 0 ? void 0 : _b.href,
+        }
+        : {
+            agent: ctx.options.agent,
+            // Hỗ trợ Undici Dispatcher cho Node.js 18+ native fetch
+            dispatcher: ctx.options.agent,
+        }));
     const response = await ctx.options.polyfill(url, _options);
     const setCookieRaw = response.headers.get("set-cookie");
     if (setCookieRaw && !raw) {

package/dist/zalo.js

@@ -75,7 +75,8 @@ export class Zalo {
         if (!options)
             options = {};
         if (!options.userAgent)
-            options.userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:133.0) Gecko/20100101 Firefox/133.0";
+            options.userAgent =
+                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36";
         if (!options.language)
             options.language = "vi";
         const ctx = createContext(this.options.apiType, this.options.apiVersion);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@softtynet/zca-js",
-    "version": "2.1.16",
+    "version": "2.1.18",
     "description": "Unofficial Zalo API for JavaScript",
     "main": "dist/index.js",
     "type": "module",