@trungdlp/zca-js 1.0.0

package/dist/apis/updateSettings.js

@@ -0,0 +1,90 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export var UpdateSettingsType;
+(function (UpdateSettingsType) {
+    UpdateSettingsType["ViewBirthday"] = "view_birthday";
+    UpdateSettingsType["ShowOnlineStatus"] = "show_online_status";
+    UpdateSettingsType["DisplaySeenStatus"] = "display_seen_status";
+    UpdateSettingsType["ReceiveMessage"] = "receive_message";
+    UpdateSettingsType["AcceptCall"] = "accept_stranger_call";
+    UpdateSettingsType["AddFriendViaPhone"] = "add_friend_via_phone";
+    UpdateSettingsType["AddFriendViaQR"] = "add_friend_via_qr";
+    UpdateSettingsType["AddFriendViaGroup"] = "add_friend_via_group";
+    UpdateSettingsType["AddFriendViaContact"] = "add_friend_via_contact";
+    UpdateSettingsType["DisplayOnRecommendFriend"] = "display_on_recommend_friend";
+    UpdateSettingsType["ArchivedChat"] = "archivedChatStatus";
+    UpdateSettingsType["QuickMessage"] = "quickMessageStatus";
+})(UpdateSettingsType || (UpdateSettingsType = {}));
+export const updateSettingsFactory = apiFactory()((_api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`https://wpa.chat.zalo.me/api/setting/update`);
+    /**
+     * Set account settings
+     *
+     * @param type The type of setting to update
+     * @param value
+     *
+     * ViewBirthday
+     * * 0: hide
+     * * 1: show full day/month/year
+     * * 2: show day/month
+     *
+     * ShowOnlineStatus
+     * * 0: hide
+     * * 1: show
+     *
+     * DisplaySeenStatus
+     * * 0: hide
+     * * 1: show
+     *
+     * ReceiveMessage
+     * * 1: everyone
+     * * 2: only friends
+     *
+     * AcceptCall
+     * * 2: only friends
+     * * 3: everyone
+     * * 4: friends and person who contacted
+     *
+     * AddFriendViaPhone
+     * * 0: disable
+     * * 1: enable
+     *
+     * AddFriendViaQR
+     * * 0: disable
+     * * 1: enable
+     *
+     * AddFriendViaGroup
+     * * 0: disable
+     * * 1: enable
+     *
+     * AddFriendViaContact
+     * * 0: disable
+     * * 1: enable
+     *
+     * DisplayOnRecommendFriend
+     * * 0: disable
+     * * 1: enable
+     *
+     * ArchivedChat
+     * * 0: disable
+     * * 1: enable
+     *
+     * QuickMessage
+     * * 0: disable
+     * * 1: enable
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function updateSettings(type, value) {
+        const params = {
+            [type]: value,
+        };
+        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/updateStatus.d.ts

@@ -0,0 +1,2 @@
+export type UpdateStatusResponse = "";
+export declare const updateStatusFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (status: string) => Promise<"">;

package/dist/apis/updateStatus.js

@@ -0,0 +1,27 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const updateStatusFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/profile/status`);
+    /**
+     * Update status
+     *
+     * @param status status for update bio
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function updateStatus(status) {
+        const params = {
+            status: status,
+        };
+        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: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/upgradeGroupCommunity.d.ts

@@ -0,0 +1,2 @@
+export type UpgradeGroupCommunityResponse = "";
+export declare const upgradeGroupCommunityFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (groupId: string) => Promise<"">;

package/dist/apis/upgradeGroupCommunity.js

@@ -0,0 +1,27 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const upgradeGroupCommunityFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/group/upgrade/community`);
+    /**
+     * Upgrade group to community
+     *
+     * @param groupId Group ID upgrade
+     *
+     * @note Zalo account identity must be verified and the account must be over 18 to use
+     * @code 185 The limit on the number of communities that can own has been reached
+     * @throws {ZaloApiError}
+     */
+    return async function upgradeGroupCommunity(groupId) {
+        const params = {
+            grId: groupId,
+            language: ctx.language,
+        };
+        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/uploadAttachment.d.ts

@@ -0,0 +1,50 @@
+import { ThreadType, type AttachmentSource } from "../models/index.js";
+export type UploadAttachmentImageResponse = {
+    normalUrl: string;
+    photoId: string;
+    finished: number | boolean;
+    hdUrl: string;
+    thumbUrl: string;
+    clientFileId: number;
+    chunkId: number;
+    fileType: "image";
+    width: number;
+    height: number;
+    totalSize: number;
+    hdSize: number;
+};
+export type UploadAttachmentVideoResponse = {
+    finished: number | boolean;
+    clientFileId: number;
+    chunkId: number;
+    fileType: "video";
+    fileUrl: string;
+    fileId: string;
+    checksum: string;
+    totalSize: number;
+    fileName: string;
+};
+export type UploadAttachmentFileResponse = {
+    finished: number | boolean;
+    clientFileId: number;
+    chunkId: number;
+    fileType: "others";
+    fileUrl: string;
+    fileId: string;
+    checksum: string;
+    totalSize: number;
+    fileName: string;
+};
+export type ImageData = {
+    fileName: string;
+    totalSize: number | undefined;
+    width: number | undefined;
+    height: number | undefined;
+};
+export type FileData = {
+    fileName: string;
+    totalSize: number;
+};
+export type UploadAttachmentType = UploadAttachmentImageResponse | UploadAttachmentVideoResponse | UploadAttachmentFileResponse;
+export type UploadAttachmentResponse = UploadAttachmentType[];
+export declare const uploadAttachmentFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (sources: AttachmentSource | AttachmentSource[], threadId: string, type?: ThreadType) => Promise<UploadAttachmentType[]>;

package/dist/apis/uploadAttachment.js

@@ -0,0 +1,196 @@
+import FormData from "form-data";
+import fs from "node:fs";
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { ThreadType } from "../models/index.js";
+import { apiFactory, getFileExtension, getFileName, getFileSize, getImageMetaData, getMd5LargeFileObject, resolveResponse, } from "../utils.js";
+const urlType = {
+    image: "photo_original/upload",
+    video: "asyncfile/upload",
+    others: "asyncfile/upload",
+};
+export const uploadAttachmentFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = `${api.zpwServiceMap.file[0]}/api`;
+    const { sharefile } = ctx.settings.features;
+    function isExceedMaxFile(totalFile) {
+        return totalFile > sharefile.max_file;
+    }
+    function isExceedMaxFileSize(fileSize) {
+        return fileSize > sharefile.max_size_share_file_v3 * 1024 * 1024;
+    }
+    function isExtensionValid(ext) {
+        return sharefile.restricted_ext_file.indexOf(ext) == -1;
+    }
+    /**
+     * Upload an attachment to a thread
+     *
+     * @param sources path to files or attachment sources
+     * @param threadId Group or User ID
+     * @param type Message type (User or Group)
+     *
+     * @throws {ZaloApiError | ZaloApiMissingImageMetadataGetter}
+     */
+    return async function uploadAttachment(sources, threadId, type = ThreadType.User) {
+        if (!sources)
+            throw new ZaloApiError("Missing sources");
+        if (!Array.isArray(sources))
+            sources = [sources];
+        if (sources.length == 0)
+            throw new ZaloApiError("Missing sources");
+        if (isExceedMaxFile(sources.length))
+            throw new ZaloApiError("Exceed maximum file of " + sharefile.max_file);
+        if (!threadId)
+            throw new ZaloApiError("Missing threadId");
+        const chunkSize = ctx.settings.features.sharefile.chunk_size_file;
+        const isGroupMessage = type == ThreadType.Group;
+        const attachmentsData = [];
+        const url = `${serviceURL}/${isGroupMessage ? "group" : "message"}/`;
+        const typeParam = isGroupMessage ? "11" : "2";
+        let clientId = Date.now();
+        for (const source of sources) {
+            const isFilePath = typeof source == "string";
+            const isBuffer = typeof source == "object" && source.data instanceof Buffer;
+            if (!isFilePath && !isBuffer)
+                throw new ZaloApiError("Invalid source type");
+            if (!isFilePath && !source.filename)
+                throw new ZaloApiError("Missing filename");
+            if (isFilePath && !fs.existsSync(source))
+                throw new ZaloApiError("File not found");
+            const extFile = getFileExtension(isFilePath ? source : source.filename).toLowerCase();
+            const fileName = isFilePath ? getFileName(source) : source.filename;
+            if (isExtensionValid(extFile) == false)
+                throw new ZaloApiError(`File extension "${extFile}" is not allowed`);
+            const data = {
+                filePath: isFilePath ? source : source.filename,
+                chunkContent: [],
+                params: {},
+                source,
+            };
+            if (isGroupMessage)
+                data.params.grid = threadId;
+            else
+                data.params.toid = threadId;
+            switch (extFile) {
+                case "jpg":
+                case "jpeg":
+                case "png":
+                case "webp": {
+                    const imageData = isFilePath ? await getImageMetaData(ctx, source) : Object.assign(Object.assign({}, source.metadata), { fileName });
+                    if (isExceedMaxFileSize(imageData.totalSize))
+                        throw new ZaloApiError(`File ${fileName} size exceed maximum size of ${sharefile.max_size_share_file_v3}MB`);
+                    data.fileData = imageData;
+                    data.fileType = "image";
+                    data.params.totalChunk = Math.ceil(data.fileData.totalSize / chunkSize);
+                    data.params.fileName = fileName;
+                    data.params.clientId = clientId++;
+                    data.params.totalSize = imageData.totalSize;
+                    data.params.imei = ctx.imei;
+                    data.params.isE2EE = 0;
+                    data.params.jxl = 0;
+                    data.params.chunkId = 1;
+                    break;
+                }
+                case "mp4": {
+                    const videoSize = isFilePath ? await getFileSize(source) : source.metadata.totalSize;
+                    if (isExceedMaxFileSize(videoSize))
+                        throw new ZaloApiError(`File ${fileName} size exceed maximum size of ${sharefile.max_size_share_file_v3}MB`);
+                    data.fileType = "video";
+                    data.fileData = {
+                        fileName,
+                        totalSize: videoSize,
+                    };
+                    data.params.totalChunk = Math.ceil(data.fileData.totalSize / chunkSize);
+                    data.params.fileName = fileName;
+                    data.params.clientId = clientId++;
+                    data.params.totalSize = videoSize;
+                    data.params.imei = ctx.imei;
+                    data.params.isE2EE = 0;
+                    data.params.jxl = 0;
+                    data.params.chunkId = 1;
+                    break;
+                }
+                default: {
+                    const fileSize = isFilePath ? await getFileSize(source) : source.metadata.totalSize;
+                    if (isExceedMaxFileSize(fileSize))
+                        throw new ZaloApiError(`File ${fileName} size exceed maximum size of ${sharefile.max_size_share_file_v3}MB`);
+                    data.fileType = "others";
+                    data.fileData = {
+                        fileName,
+                        totalSize: fileSize,
+                    };
+                    data.params.totalChunk = Math.ceil(data.fileData.totalSize / chunkSize);
+                    data.params.fileName = fileName;
+                    data.params.clientId = clientId++;
+                    data.params.totalSize = fileSize;
+                    data.params.imei = ctx.imei;
+                    data.params.isE2EE = 0;
+                    data.params.jxl = 0;
+                    data.params.chunkId = 1;
+                    break;
+                }
+            }
+            const fileBuffer = isFilePath ? await fs.promises.readFile(source) : source.data;
+            for (let i = 0; i < data.params.totalChunk; i++) {
+                const formData = new FormData();
+                const slicedBuffer = fileBuffer.subarray(i * chunkSize, (i + 1) * chunkSize);
+                formData.append("chunkContent", slicedBuffer, {
+                    filename: fileName,
+                    contentType: "application/octet-stream",
+                });
+                data.chunkContent[i] = formData;
+            }
+            attachmentsData.push(data);
+        }
+        const requests = [], results = [];
+        for (const data of attachmentsData) {
+            for (let i = 0; i < data.params.totalChunk; i++) {
+                const encryptedParams = utils.encodeAES(JSON.stringify(data.params));
+                if (!encryptedParams)
+                    throw new ZaloApiError("Failed to encrypt message");
+                requests.push(utils
+                    .request(utils.makeURL(url + urlType[data.fileType], { type: typeParam, params: encryptedParams }), {
+                    method: "POST",
+                    headers: data.chunkContent[i].getHeaders(),
+                    body: data.chunkContent[i].getBuffer(),
+                })
+                    .then(async (response) => {
+                    /**
+                     * @TODO: better type rather than any
+                     */
+                    const resData = await resolveResponse(ctx, response);
+                    if (resData && resData.fileId != "-1" && resData.photoId != "-1")
+                        await new Promise((resolve) => {
+                            if (data.fileType == "video" || data.fileType == "others") {
+                                const uploadCallback = async (wsData) => {
+                                    const result = Object.assign(Object.assign(Object.assign({ fileType: data.fileType }, resData), wsData), { totalSize: data.fileData.totalSize, fileName: data.fileData.fileName, checksum: (await getMd5LargeFileObject(data.source, data.fileData.totalSize)).data });
+                                    results.push(result);
+                                    resolve();
+                                };
+                                ctx.uploadCallbacks.set(resData.fileId.toString(), uploadCallback);
+                            }
+                            if (data.fileType == "image") {
+                                const result = {
+                                    fileType: "image",
+                                    width: data.fileData.width,
+                                    height: data.fileData.height,
+                                    totalSize: data.fileData.totalSize,
+                                    hdSize: data.fileData.totalSize,
+                                    finished: resData.finished,
+                                    normalUrl: resData.normalUrl,
+                                    hdUrl: resData.hdUrl,
+                                    thumbUrl: resData.thumbUrl,
+                                    chunkId: resData.chunkId,
+                                    photoId: resData.photoId,
+                                    clientFileId: resData.clientFileId,
+                                };
+                                results.push(result);
+                                resolve();
+                            }
+                        });
+                }));
+                data.params.chunkId++;
+            }
+        }
+        await Promise.all(requests);
+        return results;
+    };
+});

package/dist/apis/uploadProductPhoto.d.ts

@@ -0,0 +1,14 @@
+import type { AttachmentSource } from "../models/index.js";
+export type UploadProductPhotoPayload = {
+    file: AttachmentSource;
+};
+export type UploadProductPhotoResponse = {
+    normalUrl: string;
+    photoId: string;
+    finished: number;
+    hdUrl: string;
+    thumbUrl: string;
+    clientFileId: number;
+    chunkId: number;
+};
+export declare const uploadProductPhotoFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (payload: UploadProductPhotoPayload) => Promise<UploadProductPhotoResponse>;

package/dist/apis/uploadProductPhoto.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import FormData from "form-data";
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory, getImageMetaData } from "../utils.js";
+export const uploadProductPhotoFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/product/upload/photo`);
+    /**
+     * Upload product photo for api quick message, product catalog or custom local storage
+     *
+     * @param payload file path or attachment source
+     *
+     * @throws {ZaloApiError | ZaloApiMissingImageMetadataGetter}
+     */
+    return async function uploadProductPhoto(payload) {
+        const isSourceFilePath = typeof payload.file == "string";
+        const fileMetaData = isSourceFilePath
+            ? await getImageMetaData(ctx, payload.file)
+            : payload.file.metadata;
+        const fileSize = fileMetaData.totalSize || 0;
+        const fileBuffer = isSourceFilePath
+            ? await fs.promises.readFile(payload.file)
+            : payload.file.data;
+        const formData = new FormData();
+        formData.append("chunkContent", fileBuffer, {
+            filename: "undefined",
+            contentType: "application/octet-stream",
+        });
+        const params = {
+            totalChunk: 1,
+            fileName: `Base64_Img_Picker_${Date.now()}.jpg`,
+            clientId: Date.now(),
+            totalSize: fileSize,
+            imei: ctx.imei,
+            chunkId: 1,
+            toid: ctx.loginInfo.send2me_id,
+            featureId: 1,
+        };
+        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: "POST",
+            headers: formData.getHeaders(),
+            body: formData.getBuffer(),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/votePoll.d.ts

@@ -0,0 +1,5 @@
+import type { PollOptions } from "../models/index.js";
+export type VotePollResponse = {
+    options: PollOptions[];
+};
+export declare const votePollFactory: (ctx: import("../context.js").ContextBase, api: import("../apis.js").API) => (pollId: number, optionId: number | number[]) => Promise<VotePollResponse>;

package/dist/apis/votePoll.js

@@ -0,0 +1,29 @@
+import { ZaloApiError } from "../Errors/ZaloApiError.js";
+import { apiFactory } from "../utils.js";
+export const votePollFactory = apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.group[0]}/api/poll/vote`);
+    /**
+     * Vote on a poll
+     *
+     * @param pollId The ID of the poll to vote on
+     * @param optionId The ID(s) of the option to vote on
+     *
+     * @throws ZaloApiError
+     */
+    return async function votePoll(pollId, optionId) {
+        if (!Array.isArray(optionId))
+            optionId = [optionId];
+        const params = {
+            poll_id: pollId,
+            option_ids: optionId, // unvote = empty array
+            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);
+    };
+});