@softtynet/zca-js 2.3.5 → 2.3.7

package/dist/realtime/listener.js

@@ -314,18 +314,19 @@ export class Listener extends EventEmitter {
     }
     sendWs(payload, requireId = true) {
         if (this.ws && (this.ws.readyState === undefined || this.ws.readyState === WebSocket.OPEN)) {
-            if (requireId)
-                payload.data["req_id"] = `req_${this.id++}`;
+            if (requireId) {
+                const reqId = `req_${this.id++}`;
+                payload.data["req_id"] = reqId;
+                payload.data["reqId"] = reqId;
+            }
             const encodedData = new TextEncoder().encode(JSON.stringify(payload.data));
             const dataLength = encodedData.length;
-            const data = new DataView(Buffer.alloc(4 + dataLength).buffer);
-            data.setUint8(0, payload.version);
-            data.setInt32(1, payload.cmd, true);
-            data.setInt8(3, payload.subCmd);
-            encodedData.forEach((e, i) => {
-                data.setUint8(4 + i, e);
-            });
-            this.ws.send(data);
+            const buf = Buffer.alloc(4 + dataLength);
+            buf.writeUInt8(payload.version, 0);
+            buf.writeUInt16LE(payload.cmd, 1);
+            buf.writeInt8(payload.subCmd, 3);
+            Buffer.from(encodedData).copy(buf, 4);
+            this.ws.send(buf);
         }
     }
     /**
@@ -360,16 +361,36 @@ export class Listener extends EventEmitter {
         this.sendWs(payload);
     }
     /**
-     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL và `cmd 604` CTRL_PULL_VOIP).
-     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông ngay cả khi vừa mở kết nối WebSocket.
+     * Kéo danh sách tin nhắn cụ thể theo `queueId` và mảng `ids` (`cmd 570` GET_MSG)
+     * khi nhận tín hiệu `cmd 533` (`HAS_MSG`) từ Zalo WebSocket (thường dùng cho tin nhắn OA / ZNS / Missed Queue).
+     * Tự động chia batch tối đa 20 ID mỗi gói theo đúng cấu hình `max_msg_get = 20` trên Zalo Desktop.
+     */
+    requestMessagesByIds(queueId, ids, lastId = "0") {
+        if (!queueId || !Array.isArray(ids) || ids.length === 0)
+            return;
+        const maxBatchSize = 20;
+        for (let i = 0; i < ids.length; i += maxBatchSize) {
+            const chunk = ids.slice(i, i + maxBatchSize);
+            const reqId = `req_${this.id++}`;
+            this.sendWs({
+                version: 1,
+                cmd: 570,
+                subCmd: 0,
+                data: {
+                    queueId,
+                    ids: chunk,
+                    lastId,
+                    reqId,
+                    req_id: reqId,
+                },
+            }, false);
+        }
+    }
+    /**
+     * Kích hoạt và kéo hàng đợi sự kiện điều khiển / VoIP (`cmd 603` CTRL_PULL_CTRL).
+     * Giúp nhận ngay các cuộc gọi đến đang đổ chuông và sự kiện điều khiển ngay cả khi vừa mở kết nối WebSocket.
      */
     requestOfflineVoipControls() {
-        this.sendWs({
-            version: 1,
-            cmd: 604,
-            subCmd: 0,
-            data: { first: true, lastId: 1, preIds: [] },
-        });
         this.sendWs({
             version: 1,
             cmd: 603,

package/dist/realtime/types.d.ts

@@ -1,11 +1,23 @@
 import type { FriendEvent } from "../models/FriendEvent.js";
 import type { GroupEvent } from "../models/GroupEvent.js";
-import type { Message, Reaction, Undo, Typing, ThreadType } from "../models/index.js";
+import type { Message, Reaction, Undo, Typing, ThreadType, UserMessage } from "../models/index.js";
 import type { SeenMessage } from "../models/SeenMessage.js";
 import type { DeliveredMessage } from "../models/DeliveredMessage.js";
 import type { ClearUnread } from "../models/ClearUnread.js";
 import type { SyncEvent } from "../models/SyncEvent.js";
 import type { CallEvent } from "../models/CallEvent.js";
+import type { OAEvent } from "../models/OAMessage.js";
+export type HasMsgQueueId = {
+    cmd: number;
+    subCmd: number;
+    queueName?: string;
+    [key: string]: unknown;
+};
+export type HasMsgIdItem = {
+    actionId: string;
+    msgId?: string;
+    [key: string]: unknown;
+};
 export type UploadEventData = {
     fileUrl: string;
     fileId: string;
@@ -45,6 +57,7 @@ export interface ListenerEvents {
     error: [error: unknown];
     typing: [typing: Typing];
     message: [message: Message];
+    oa_message: [message: UserMessage];
     old_messages: [messages: Message[], type: ThreadType, hasMore?: boolean];
     seen_messages: [messages: SeenMessage[]];
     delivered_messages: [messages: DeliveredMessage[]];
@@ -57,6 +70,7 @@ export interface ListenerEvents {
     group_event: [data: GroupEvent];
     sync_event: [data: SyncEvent];
     call_event: [data: CallEvent];
+    oa_event: [data: OAEvent];
     voice2text_event: [data: Voice2TextEvent];
     cipher_key: [key: string];
     ping: [];

package/dist/utils.js

@@ -3,7 +3,7 @@ import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import SparkMD5 from "spark-md5";
-import toughCookie from "tough-cookie";
+import * as toughCookie from "tough-cookie";
 import { isContextSession } from "./context.js";
 import { ZaloApiError, ZaloApiMissingImageMetadataGetter } from "./Errors/index.js";
 import { FriendEventType } from "./models/FriendEvent.js";

package/dist/zalo.d.ts

@@ -1,6 +1,6 @@
 import { type LoginQRCallback } from "./apis/loginQR.js";
 import { type Options } from "./context.js";
-import toughCookie from "tough-cookie";
+import * as toughCookie from "tough-cookie";
 import { API } from "./apis.js";
 export type Cookie = {
     domain: string;

package/dist/zalo.js

@@ -2,7 +2,7 @@ import { loginQR, LoginQRCallbackEventType } from "./apis/loginQR.js";
 import { getServerInfo, login } from "./apis/login.js";
 import { createContext, isContextSession, } from "./context.js";
 import { generateZaloUUID, logger, ZALO_DEFAULTS, ZALO_DOMAINS } from "./utils.js";
-import toughCookie from "tough-cookie";
+import * as toughCookie from "tough-cookie";
 import { ZaloApiError } from "./Errors/ZaloApiError.js";
 import { checkUpdate } from "./update.js";
 import { API } from "./apis.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@softtynet/zca-js",
-    "version": "2.3.5",
+    "version": "2.3.7",
     "description": "Zalo API client library for Node.js and Bun, maintained by Softtynet.",
     "main": "dist/cjs/index.cjs",
     "module": "dist/index.js",
@@ -30,6 +30,7 @@
         "test:verify": "npm run typecheck && npx --yes tsx test/verify_upgrades.ts",
         "test:live": "npx --yes tsx test/verify_live.ts",
         "test:call-studio": "npm run build && npx --yes tsx test/call_studio_server.ts",
+        "test:oa-studio": "npm run build && npx --yes tsx test/oa_studio_server.ts",
         "docs:gen": "node scripts/generateDocs.js",
         "docs:dev": "node scripts/generateDocs.js && vitepress dev docs",
         "docs:build": "node scripts/generateDocs.js && vitepress build docs",