@zenify-omni/chat-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zenify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# @zenify-omni/chat-js
+
+Tầng logic của [Zenify](https://zenify.vn) Chat — API, xác thực, socket. **Không
+phụ thuộc React**, chạy được với bất kỳ framework nào.
+
+Phần lớn ứng dụng không dùng gói này trực tiếp mà qua
+[`@zenify-omni/chat-ui-react-js`](https://www.npmjs.com/package/@zenify-omni/chat-ui-react-js).
+
+```bash
+npm i @zenify-omni/chat-js
+```
+
+```js
+import { createChatClient } from '@zenify-omni/chat-js'
+import { configureChatEnv } from '@zenify-omni/chat-js/config/env.js'
+
+const client = createChatClient({ email: 'agent@congty.vn', apiKey: '<API KEY>' })
+await client.start()
+```
+
+Mặc định trỏ vào hạ tầng production của Zenify; ghi đè bằng
+`configureChatEnv({ API_EVS_URL, HUB_URL, … })` nếu cần.
+
+Import sâu phải ghi đủ đuôi `.js`.
+
+## Giấy phép
+
+MIT

package/api/campaign.js

@@ -0,0 +1,19 @@
+import { requestApi } from "../utils/request.js";
+function getAllCampaigns(params) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/all-campaigns",
+    params
+  });
+}
+function assignAgent({ data }) {
+  return requestApi({
+    method: "post",
+    endpoint: `/v2/campaigns/assign-agents`,
+    data
+  });
+}
+export {
+  assignAgent,
+  getAllCampaigns
+};

package/api/chat.js

@@ -0,0 +1,518 @@
+import { requestApi, requestHubApi, requestZaloApi } from "../utils/request.js";
+function getChatList(limit = 500, offset = 0) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/chat/list",
+    params: { limit, offset }
+  });
+}
+function getChatListV2({ params }) {
+  const options = {
+    method: "get",
+    endpoint: "/v2/chat/list",
+    params
+  };
+  return requestApi(options);
+}
+function getAllChat(skipFromId) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/chat/all",
+    params: { skipFromId }
+  });
+}
+function getDetailChat(id) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/chat/detail/" + id
+  });
+}
+function getChatContent(id, options) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/chat/content/" + id,
+    params: options
+  });
+}
+function getLastChatHistory(exceptTicketId, requesterId, skipFromId, limit = 30) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/chat/last-history",
+    params: { exceptTicketId, requesterId, limit, skipFromId }
+  });
+}
+function saveChatIntoTicket(id) {
+  return requestApi({
+    method: "post",
+    endpoint: "/v2/save-to-ticket/" + id
+  });
+}
+function getAgentInTicket(id) {
+  return requestApi({
+    method: "get",
+    endpoint: "/v2/agents-in-ticket/" + id
+  });
+}
+function joinToChat(roomId) {
+  return requestApi({
+    method: "post",
+    endpoint: "/v2/chat/join-to-chat",
+    data: { roomId }
+  });
+}
+function receiveChat(roomId) {
+  return requestApi({
+    method: "post",
+    endpoint: "/v2/chat/receive-chat",
+    data: { roomId }
+  });
+}
+function leaveChat(roomId) {
+  return requestApi({
+    method: "post",
+    endpoint: "/v2/chat/leave-chat",
+    data: { roomId }
+  });
+}
+function assignChat(data) {
+  return requestApi({
+    method: "post",
+    endpoint: "/v2/chat/assign-chat",
+    data
+  });
+}
+const getChatFlag = (params) => {
+  const options = {
+    method: "get",
+    endpoint: `/v2/chat-flag`
+  };
+  if (params) {
+    options.params = params;
+  }
+  return requestApi(options);
+};
+const createChatFlag = (payload) => requestApi({
+  method: "post",
+  endpoint: "/v2/chat-flag",
+  data: payload
+});
+const updateChatFlag = (id, payload) => requestApi({
+  method: "put",
+  endpoint: `/v2/chat-flag/${id}`,
+  data: payload
+});
+const deleteChatFlag = (id) => requestApi({
+  method: "delete",
+  endpoint: `/v2/chat-flag/${id}`
+});
+const getZaloReminderList = ({ ticketId, thread_id }) => requestZaloApi({
+  method: "get",
+  endpoint: `/zalo/get-reminders/${ticketId}`,
+  params: { thread_id }
+});
+const checkAccessByPZaloConnection = ({ ticketId, userId }) => requestZaloApi({
+  method: "get",
+  endpoint: `/zalo/get-zalo-connection/${ticketId}`,
+  params: { user_id: userId }
+});
+function getListSocialPage() {
+  return requestApi({
+    method: "get",
+    endpoint: `/v2/social/page/list`
+  });
+}
+function getListSocialPageV3() {
+  return requestApi({
+    method: "get",
+    endpoint: `/v3/social/page/list`
+  });
+}
+function getListFriendRequestReceived(userId, data) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/received-friend-requests/${userId}`,
+    data
+  });
+}
+function getListFriendRequestSent(userId, data) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/sent-friend-requests/${userId}`,
+    data
+  });
+}
+function acceptFriendRequest(userId, requestId, source_id) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/accept-friend-request/${userId}`,
+    data: { customer_zalo_id: requestId, source_id }
+  });
+}
+function rejectFriendRequest(userId, requestId, source_id) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/reject-friend-request/${userId}`,
+    data: { customer_zalo_id: requestId, source_id }
+  });
+}
+function undoFriendRequest(userId, requestId, source_id) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/undo-friend-request/${userId}`,
+    data: { customer_zalo_id: requestId, source_id }
+  });
+}
+function createZaloGroup({ zaloId, payload }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/personal/${zaloId}/create-group`,
+    data: payload,
+    headers: {
+      "Content-Type": "multipart/form-data"
+    }
+  });
+}
+function updateZaloGroup({ zaloId, groupId, payload }) {
+  return requestZaloApi({
+    method: "put",
+    endpoint: `/personal/${zaloId}/update-group/${groupId}`,
+    data: payload,
+    headers: {
+      "Content-Type": "multipart/form-data"
+    }
+  });
+}
+function setFriendAlias({ zaloId, friendId, alias }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/friends/${friendId}/alias`,
+    data: { alias }
+  });
+}
+function removeFriendAlias({ zaloId, friendId }) {
+  return requestZaloApi({
+    method: "delete",
+    endpoint: `/zalo/${zaloId}/friends/${friendId}/alias`
+  });
+}
+function getListFriendZaloGroup(zaloId) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/zalo/${zaloId}/list-friend`
+  });
+}
+function addFriendToZaloGroup() {
+  return requestZaloApi({
+    method: "post",
+    endpoint: ``
+  });
+}
+function getCommonGroups({ zaloId, customerZaloId }) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/zalo/${zaloId}/related-groups/${customerZaloId}`
+  });
+}
+function getZaloGroupInfo({ zaloId, groupId, force }) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}`,
+    params: force ? { force: true } : void 0
+  });
+}
+function sendBulkMessages({ userId, zaloId, data }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/send-bulk-messages/${userId}`,
+    data,
+    headers: {
+      "Content-Type": "multipart/form-data"
+    }
+  });
+}
+function updateMembersGroup({ groupId, zaloId, memberZaloIds, action }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/members`,
+    data: {
+      member_zalo_ids: memberZaloIds,
+      action
+    }
+  });
+}
+function getMembersGroup({ zaloId, groupId, data }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/load-members`,
+    data
+  });
+}
+function getZaloGroupLinkDetail({ zaloId, groupId }) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/link`
+  });
+}
+function enableZaloGroupLink({ zaloId, groupId }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/link/enable`
+  });
+}
+function disableZaloGroupLink({ zaloId, groupId }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/link/disable`
+  });
+}
+function leaveZaloGroup({ zaloId, groupId, silent }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/leave`,
+    data: { silent }
+  });
+}
+function changeZaloGroupOwner({ zaloId, groupId, newOwnerZaloId }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/groups/${groupId}/owner`,
+    data: { new_owner_zalo_id: newOwnerZaloId }
+  });
+}
+const getPinnedMessages = (roomId) => requestZaloApi({
+  method: "get",
+  endpoint: `/zalo/pinned-messages/${roomId}`
+});
+function undoZaloMessage({
+  zaloId,
+  threadId,
+  msgId,
+  cliMsgId,
+  isGroup
+}) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/zalo/${zaloId}/undo-message`,
+    data: {
+      thread_id: threadId,
+      msg_id: msgId,
+      cli_msg_id: cliMsgId,
+      is_group: !!isGroup
+    }
+  });
+}
+function sendZaloPersonalMessageWithFiles({
+  sourceId,
+  phone,
+  userZaloId,
+  isGroup,
+  text,
+  roomId,
+  sessionId,
+  clientMsgId,
+  chatterId,
+  chatterName,
+  chatterAvatar,
+  files,
+  content
+}) {
+  const formData = new FormData();
+  formData.append("source_id", sourceId);
+  if (phone) formData.append("phone", phone);
+  formData.append("user_zalo_id", userZaloId);
+  formData.append("is_group", String(!!isGroup));
+  if (text) formData.append("text", text);
+  formData.append("room_id", roomId);
+  if (sessionId) formData.append("session_id", sessionId);
+  if (clientMsgId) formData.append("client_msg_id", clientMsgId);
+  formData.append("chatter_id", chatterId);
+  formData.append("chatter_name", chatterName);
+  if (chatterAvatar) formData.append("chatter_avatar", chatterAvatar);
+  if (content) formData.append("content", JSON.stringify(content));
+  files.forEach((file) => formData.append("files", file));
+  return requestZaloApi({
+    method: "post",
+    endpoint: "/send-message-with-files",
+    data: formData,
+    headers: {
+      "Content-Type": "multipart/form-data"
+    }
+  });
+}
+function sendZaloPersonalContactCard({
+  sourceId,
+  userZaloId,
+  isGroup,
+  roomId,
+  sessionId,
+  clientMsgId,
+  chatterId,
+  chatterName,
+  chatterAvatar,
+  contactZaloId,
+  contactName,
+  contactPhone,
+  contactAvatar
+}) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: "/send-card",
+    data: {
+      source_id: sourceId,
+      user_zalo_id: userZaloId,
+      is_group: !!isGroup,
+      room_id: roomId,
+      session_id: sessionId,
+      client_msg_id: clientMsgId,
+      chatter_id: chatterId,
+      chatter_name: chatterName,
+      chatter_avatar: chatterAvatar,
+      contact_zalo_id: contactZaloId,
+      contact_name: contactName,
+      contact_phone: contactPhone,
+      contact_avatar: contactAvatar
+    }
+  });
+}
+function forwardZaloMessage({ zaloId, data }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/personal/${zaloId}/forward-message`,
+    data
+  });
+}
+function batchForwardZaloMessage({ zaloId, data }) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/personal/${zaloId}/batch-forward-messages`,
+    data
+  });
+}
+function getForwardList(zaloId) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/zalo/${zaloId}/forward-list`
+  });
+}
+function getZaloPersonalLabels(zaloId) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/personal/${zaloId}/labels`
+  });
+}
+function getZaloPersonalLabelSettings(zaloId) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/personal/${zaloId}/label-settings`
+  });
+}
+function saveZaloPersonalLabelSettings(zaloId, hiddenLabels) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/personal/${zaloId}/label-settings`,
+    data: { hidden_labels: hiddenLabels }
+  });
+}
+function updateZaloPersonalChatLabel({
+  zaloId,
+  conversationIds,
+  labelId,
+  action
+}) {
+  return requestZaloApi({
+    method: "post",
+    endpoint: `/personal/${zaloId}/update-chat-label`,
+    data: {
+      conversation_ids: conversationIds,
+      label_id: labelId,
+      action
+    }
+  });
+}
+function getFullAvatar(sourceId, sourceRoomId) {
+  return requestZaloApi({
+    method: "get",
+    endpoint: `/personal/${sourceId}/full-avatar/${sourceRoomId}`
+  });
+}
+function pinChatRoom(id) {
+  return requestHubApi({
+    method: "post",
+    endpoint: `/api/v3/chat-rooms/${id}/pin`
+  });
+}
+function unpinChatRoom(id) {
+  return requestHubApi({
+    method: "delete",
+    endpoint: `/api/v3/chat-rooms/${id}/pin`
+  });
+}
+const checkOpenChat = ({ data }) => requestZaloApi({
+  method: "post",
+  endpoint: `/check-open-chat`,
+  data
+});
+const checkSendMessageStatus = (data) => requestZaloApi({
+  method: "post",
+  endpoint: `check-send-message-status`,
+  data
+});
+export {
+  acceptFriendRequest,
+  addFriendToZaloGroup,
+  assignChat,
+  batchForwardZaloMessage,
+  changeZaloGroupOwner,
+  checkAccessByPZaloConnection,
+  checkOpenChat,
+  checkSendMessageStatus,
+  createChatFlag,
+  createZaloGroup,
+  deleteChatFlag,
+  disableZaloGroupLink,
+  enableZaloGroupLink,
+  forwardZaloMessage,
+  getAgentInTicket,
+  getAllChat,
+  getChatContent,
+  getChatFlag,
+  getChatList,
+  getChatListV2,
+  getCommonGroups,
+  getDetailChat,
+  getForwardList,
+  getFullAvatar,
+  getLastChatHistory,
+  getListFriendRequestReceived,
+  getListFriendRequestSent,
+  getListFriendZaloGroup,
+  getListSocialPage,
+  getListSocialPageV3,
+  getMembersGroup,
+  getPinnedMessages,
+  getZaloGroupInfo,
+  getZaloGroupLinkDetail,
+  getZaloPersonalLabelSettings,
+  getZaloPersonalLabels,
+  getZaloReminderList,
+  joinToChat,
+  leaveChat,
+  leaveZaloGroup,
+  pinChatRoom,
+  receiveChat,
+  rejectFriendRequest,
+  removeFriendAlias,
+  saveChatIntoTicket,
+  saveZaloPersonalLabelSettings,
+  sendBulkMessages,
+  sendZaloPersonalContactCard,
+  sendZaloPersonalMessageWithFiles,
+  setFriendAlias,
+  undoFriendRequest,
+  undoZaloMessage,
+  unpinChatRoom,
+  updateChatFlag,
+  updateMembersGroup,
+  updateZaloGroup,
+  updateZaloPersonalChatLabel
+};