@satek-team-intern/chatbot-widget 0.11.1 → 0.11.2

package/dist/index.d.ts

@@ -1 +1,91 @@
+import { ChatWidgetProps as ChatWidgetProps_2 } from '../../types';
+import { FC } from 'react';
+
+/** Các loại định dạng tập tin được phép đính kèm từ thiết bị */
+declare type AttachmentType = 'image' | 'video' | 'audio' | 'file' | 'multiple';
+
+declare interface AuthInfo {
+    code?: string;
+    name: string;
+    avatar?: string;
+    phone?: string;
+    email?: string;
+}
+
+export declare const ChatWidget: FC<ChatWidgetProps_2>;
+
+export declare interface ChatWidgetProps {
+    scope?: WidgetScope;
+    title?: string;
+    workspace?: string;
+    logoUrl?: string;
+    primaryColor?: string;
+    auth: AuthInfo;
+    chatKey: string;
+    features?: WidgetFeature;
+    language?: LanguageOption;
+    initPosition?: PositionType;
+    disabledMembers?: string[];
+}
+
+/**
+ * Các phương thức truyền thông và ghi hình.
+ * - 'voice': Ghi âm và gửi tin nhắn thoại.
+ */
+declare type CommunicationFeature = 'voice';
+
+export declare function init(config: ChatWidgetProps): void;
+
+/** Các tùy chọn ngôn ngữ hiển thị trên giao diện */
+declare type LanguageOption = 'english' | 'vietnamese';
+
+/**
+ * Vị trí tính theo tọa độ
+ *
+ * - right: Khoảng cách từ mép phải của cửa sổ trình duyệt đến điểm đặt widget.
+ * - bottom: Khoảng cách từ mép dưới của cửa sổ trình duyệt đến điểm đặt widget.
+ */
+declare interface PositionType {
+    right: number;
+    bottom: number;
+}
+
+/**
+ * Chế độ vận hành của cửa sổ chat.
+ * - 'single': Chat 1-1.
+ * - 'group': Chế độ chat nhóm nhiều người tham gia.
+ */
+declare type WidgetChatMode = 'single' | 'group';
+
+/**
+ * Các tùy chọn can thiệp và mở rộng giao diện Widget.
+ * - 'change-color': Người dùng cuối có thể tự chọn màu chủ đạo (Primary Color).
+ * - 'change-theme': Người dùng cuối có thể chuyển đổi giữa các chủ đề (ví dụ: Sáng/Tối).
+ * - 'drag-and-drop': Hiển thị cấu hình toggle kéo thả để thay đổi vị trí của widget trên màn hình.
+ * - 'resize-window': Cho phép người dùng thay đổi kích thước cửa sổ chat bằng cách kéo thả cạnh cửa sổ.
+ */
+declare type WidgetCustomizationOptions = 'change-color' | 'change-theme' | 'drag-and-drop' | 'resize-window';
+
+declare interface WidgetFeature {
+    /** Danh sách các loại tập tin cho phép tải lên. Nếu có 'multiple', cho phép chọn nhiều file. */
+    attachments?: AttachmentType[];
+    /** Các tính năng tương tác trực tiếp bằng âm thanh và hình ảnh. */
+    communication?: CommunicationFeature[];
+    /**
+     * Xác định các hình thức hội thoại mà widget hỗ trợ.
+     * Nếu không truyền, mặc định là ['single']
+     */
+    chatModes?: WidgetChatMode[];
+    /** Các quyền tùy biến giao diện cho phép người dùng thực hiện. */
+    customizations?: WidgetCustomizationOptions[];
+}
+
+/**
+ * Phạm vi hoạt động (Ngữ cảnh môi trường) của Chat Widget.
+ *
+ * - `external`: Widget được nhúng vào các website bên ngoài (phục vụ khách vãng lai và admin).
+ * - `internal`: Widget chạy nội bộ trong hệ thống/app SaOne (phục vụ cho thành viên - member).
+ */
+declare type WidgetScope = 'external' | 'internal';
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satek-team-intern/chatbot-widget",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "A widget chatbot can be integrated into any website, providing a seamless and interactive user experience. It is designed to be easily embedded and customizable, allowing businesses to engage with their customers effectively.",
   "author": "Satek Team",
   "license": "MIT",

package/dist/constants/scenario_guest_vi.json.d.ts

@@ -1,103 +0,0 @@
-declare const _default: {
-  "meta": {
-    "version": "1.1.0",
-    "bot_name": "Trợ lý ảo",
-    "start_step": "step_ask_inform",
-    "end_step": "step_connect_agent"
-  },
-  "steps": {
-    "step_ask_inform": {
-      "type": "interactive_input",
-      "bot_message": "👋 Chào anh/chị! Em là Gàn AI - trợ lý tư vấn 24/7 của Satek",
-      "options": [
-        {
-          "label": "Tư vấn dịch vụ A",
-          "value": "dich_vu_a",
-          "next_step": "step_fill_onboarding_form"
-        },
-        {
-          "label": "Tư vấn dịch vụ B",
-          "value": "dich_vu_b",
-          "next_step": "step_fill_onboarding_form"
-        },
-        {
-          "label": "Tư vấn dịch vụ C",
-          "value": "dich_vu_c",
-          "next_step": "step_fill_onboarding_form"
-        }
-      ],
-      "edge_cases": [
-        {
-          "match_keywords": [
-            "Tư vấn dịch vụ A",
-            "Tư vấn dịch vụ B",
-            "Tư vấn dịch vụ C"
-          ],
-          "override_value": "",
-          "override_message": "",
-          "next_step": "step_fill_onboarding_form"
-        }
-      ],
-      "next_step": "step_fill_onboarding_form"
-    },
-    "step_fill_onboarding_form": {
-      "type": "form_input",
-      "bot_message": "Để tiết kiệm thời gian, bạn vui lòng điền nhanh thông tin vào form bên dưới giúp mình nhé!",
-      "fields": [
-        {
-          "save_variable": "name",
-          "label": "Họ và tên",
-          "placeholder": "Nhập họ tên đầy đủ",
-          "required": true,
-          "validation": {
-            "rule": "min_length",
-            "value": 2,
-            "error_message": "Tên hợp lệ phải từ 2 ký tự trở lên."
-          }
-        },
-        {
-          "save_variable": "email",
-          "label": "Địa chỉ Email",
-          "placeholder": "VD: nguyenvana@gmail.com",
-          "required": false,
-          "validation": {
-            "rule": "email",
-            "error_message": "Định dạng email chưa chính xác."
-          }
-        },
-        {
-          "save_variable": "phone",
-          "label": "Số điện thoại",
-          "placeholder": "Nhập số điện thoại liên hệ",
-          "required": false,
-          "validation": {
-            "rule": "phone_vn",
-            "error_message": "Số điện thoại chưa đúng định dạng VN."
-          }
-        },
-        {
-          "save_variable": "product_interest",
-          "label": "Sản phẩm quan tâm",
-          "type": "select",
-          "required": true,
-          "options": [
-            { "label": "Sản phẩm A", "value": "san_pham_a" },
-            { "label": "Sản phẩm B", "value": "san_pham_b" },
-            { "label": "Tư vấn dịch vụ khác", "value": "khac" }
-          ]
-        }
-      ],
-      "submit_button_label": "Xác nhận và gửi thông tin",
-      "next_step": "step_connect_agent"
-    },
-
-    "step_connect_agent": {
-      "type": "system_action",
-      "action_name": "FINISH_ONBOARDING",
-      "bot_message": "Tuyệt vời! Hệ thống đã chuyển toàn bộ thông tin cho nhân viên tư vấn. Bạn chờ trong giây lát nhé..."
-    }
-  }
-}
-;
-
-export default _default;

package/dist/locales/en.json.d.ts

@@ -1,331 +0,0 @@
-declare const _default: {
-  "common": {
-    "buttons": {
-      "save": "Save",
-      "cancel": "Cancel",
-      "confirm": "Confirm",
-      "close": "Close"
-    },
-    "errors": {
-      "createChat": "Cannot create chat. Please try again later.",
-      "updateGroup": "Cannot update group information. Please try again later!"
-    },
-    "fileValidation": {
-      "singleFileOnly": "Only one file attachment is allowed.",
-      "maxFilesExceeded": "Maximum {{count}} files allowed.",
-      "removeErrorFiles": "Please remove error files (exceeded {{size}} MB).",
-      "invalidFileType": "Please select only allowed file types.",
-      "corruptedFile": "Detected corrupted files or files that cannot be opened.",
-      "validationError": "An error occurred while validating file data.",
-      "checkingFileError": "Error checking files:",
-      "urlCheckingError": "Error checking file URL:"
-    },
-    "info": {
-      "notAvailable": "Unknown"
-    },
-    "validation": {
-      "requiredField": "{{label}} không được để trống."
-    }
-  },
-  "system": {
-    "name": "System",
-    "description": "This chat is used to send important notifications and updates from the system to users.",
-    "message": {
-      "liveOtp": "ChatLive Login Verification Code",
-      "liveOtpDesc": "You are logging into ChatLive Web with business code {{businessCode}}.",
-      "liveOtpDesc2": "Do not share this code with others. The code is only for the current login session."
-    }
-  },
-  "addMember": {
-    "title": "Add Member",
-    "memberSearchPlaceholder": "Search members",
-    "noMembersFound": "No members found",
-    "addButton": "Add",
-    "addMemberSuccess": "Member added to group successfully!",
-    "addMemberError": "Cannot add member. Please try again!",
-    "membersSection": "Suggested Members"
-  },
-  "addChat": {
-    "title": "Create Group",
-    "groupNamePlaceholder": "Group name",
-    "memberSearchPlaceholder": "Search members",
-    "selectMembers": "Create Group",
-    "cancelButton": "Cancel",
-    "createChatError": "Cannot create conversation. Please try again later.",
-    "membersSection": "Suggested Members",
-    "createGroup": "Create Group",
-    "selectMoreMembers": "Select more members",
-    "firstMessage": "Hi, I need support!"
-  },
-  "updateGroup": {
-    "title": "Update Group",
-    "groupNamePlaceholder": "Group name",
-    "membersSection": "Members",
-    "removeMemberButtonTitle": "Remove member",
-    "cancelButton": "Cancel",
-    "updateButton": "Update",
-    "updatingButton": "Updating...",
-    "updateSuccess": "Group updated successfully",
-    "updateError": "Error updating group",
-    "removeMemberConfirm": "Are you sure you want to remove this member from the group?",
-    "leftGroupSuccess": "You have left this group",
-    "removeMemberSuccess": "Member removed from group",
-    "removeMemberError": "Cannot remove member. Please try again!",
-    "youLabel": "You",
-    "leaderLabel": "Leader",
-    "groupNameLabel": "Group Name",
-    "avatarUrlLabel": "Avatar URL",
-    "avatarUrlPlaceholder": "Enter avatar URL (optional)...",
-    "uploadAvatarButton": "Upload Avatar",
-    "removeConfirmationStart": "Are you sure you want to remove member",
-    "removeConfirmationEnd": "from the group?"
-  },
-  "userProfileModal": {
-    "statusActive": "Active",
-    "statusInactive": "Inactive",
-    "messageButton": "Message",
-    "departmentLabel": "Department",
-    "departmentValue": "Technical",
-    "roleLabel": "Role",
-    "roleValue": "Member",
-    "dateOfBirthLabel": "Date of birth",
-    "dateOfBirthValue": "05/11/1994",
-    "emailLabel": "Email",
-    "phoneLabel": "Phone",
-    "notAvailable": "Not available"
-  },
-  "chatInfoPanel": {
-    "groupManagementTitle": "Group Management",
-    "allowGroupMembers": "Allow group members to:",
-    "canChangeGroupInfo": "Change group name & avatar",
-    "canPinMessage": "Pin messages, notes, polls at the top of the conversation",
-    "canCreateNote": "Create new notes and reminders",
-    "canCreatePoll": "Create new polls",
-    "canSendMessage": "Send messages",
-    "approveNewMembersLabel": "New member approval mode",
-    "markAdminMessagesLabel": "Mark messages from leaders/vice leaders",
-    "allowNewMembersReadRecentLabel": "Allow new members to read recent messages",
-    "blockFromGroup": "Block from group",
-    "leaderAndViceLeader": "Leader & Vice Leader",
-    "deleteChatConfirm": "Are you sure you want to delete this conversation?",
-    "deleteChatSuccess": "Conversation deleted successfully.",
-    "deleteChatError": "An error occurred while deleting the conversation.",
-    "membersLabel": "Members ({count})",
-    "statusActive": "Active",
-    "statusInactive": "Inactive",
-    "addButtonLabel": "Add",
-    "youLabel": "You",
-    "leaderLabel": "Leader",
-    "memberLabel": "Member",
-    "removeFromGroupMenu": "Remove from group",
-    "deleteChatHistory": "Delete chat history"
-  },
-  "chatWindow": {
-    "memberSystem": "System Members",
-    "dragFile": "Drop files here",
-    "selectChat": "Select a conversation",
-    "startConversation": "Start a conversation with support or your team",
-    "searchPlaceholder": "Search conversations",
-    "filterAll": "All",
-    "filterGroup": "Group Chat",
-    "filterSingle": "1-1 Chat",
-    "filterUnread": "Unread",
-    "removeMemberConfirm": "Are you sure you want to remove this member from the group?",
-    "leftGroupSuccess": "You have left this group",
-    "removeMemberSuccess": "Member removed from group",
-    "removeMemberError": "Cannot remove member. Please try again!",
-    "createChatError": "Cannot create chat. Please try again later.",
-    "removeChatConfirm": "Are you sure you want to delete this conversation?",
-    "removeChatSuccess": "Conversation deleted",
-    "removeChatError": "Cannot delete conversation. Please try again!",
-    "unreadFilterLabel": "Unread",
-    "searchFilterAll": "All",
-    "searchFilterMembers": "Members",
-    "searchFilterMessages": "Messages",
-    "searchFilterFiles": "Files",
-    "searchSectionMembers": "Members",
-    "searchSectionMessages": "Messages",
-    "searchSectionFiles": "Files",
-    "viewAllMembers": "View all members",
-    "viewAllMessages": "View all messages",
-    "viewAllFiles": "View all files",
-    "contactCategoryMembers": "Member List",
-    "contactCategoryGroups": "Group List",
-    "statusLoading": "Loading...",
-    "statusActive": "Active",
-    "statusInactive": "Inactive",
-    "memberSuffix": "members"
-  },
-  "chatHeader": {
-    "defaultTitle": "Chat List",
-    "darkMode": "Dark Mode",
-    "lightMode": "Light Mode",
-    "addMember": "Add Member",
-    "settings": "UI Settings",
-    "minimize": "Minimize",
-    "maximize": "Maximize",
-    "close": "Close",
-    "language": "Change Language",
-    "subtitle": "Internal Chat"
-  },
-  "chatInput": {
-    "placeholder": "Enter message...",
-    "selectFiles": "Select files",
-    "recordVoice": "Record voice",
-    "selectFilesOrOptions": "Select files or options",
-    "removeFile": "Remove file",
-    "recording": "Recording",
-    "cancelRecording": "Cancel recording",
-    "stopRecording": "Stop recording",
-    "playRecording": "Play recording",
-    "discardRecording": "Discard recording",
-    "addToMessage": "Add to message",
-    "voiceMessage": "Voice message",
-    "replyingTo": "Replying to",
-    "attachmentIndicator": "[Attachment]",
-    "fileAttachmentDisabled": "File attachment feature has not been activated.",
-    "fileTypeNotAllowed": "File type is not allowed.",
-    "selectedFileTypeNotAllowed": "Selected file type is not allowed.",
-    "fileSizeExceeded": "Exceeded {{size}} MB",
-    "userDisabled": "This user has been disabled.",
-    "messageSendingDisabled": "You cannot send messages."
-  },
-  "chatMessage": {
-    "actions": {
-      "like": "Like",
-      "love": "Love",
-      "reply": "Reply",
-      "delete": "Delete",
-      "revoke": "Revoke",
-      "seeMore": "See more",
-      "seeLess": "See less"
-    },
-    "status": {
-      "seen": "Seen",
-      "sent": "Sent"
-    },
-    "states": {
-      "revoked": "Message revoked",
-      "removed": "Message removed",
-      "attachment": "[Attachment]"
-    }
-  },
-  "chatList": {
-    "options": "Options",
-    "editGroup": "Edit Group",
-    "addMember": "Add Member",
-    "deleteGroup": "Delete Group",
-    "delete": "Delete",
-    "yourMessage": "You: ",
-    "allChats": "All Messages",
-    "emptyChats": "No conversations yet"
-  },
-  "chatSearchBar": {
-    "searchPlaceholder": "Search...",
-    "createGroup": "Create New Group"
-  },
-  "fileViewer": {
-    "closeButtonTitle": "Close (ESC)",
-    "previousButtonTitle": "Previous Image (←)",
-    "nextButtonTitle": "Next Image (→)",
-    "scrollLeftTitle": "Scroll Left",
-    "scrollRightTitle": "Scroll Right",
-    "openDownloadButton": "Open / Download",
-    "closeAriaLabel": "Close file viewer",
-    "previousAriaLabel": "Previous image",
-    "nextAriaLabel": "Next image",
-    "scrollLeftAriaLabel": "Scroll thumbnails left",
-    "scrollRightAriaLabel": "Scroll thumbnails right",
-    "pdfCheckingStatus": "Checking file integrity...",
-    "pdfErrorMessage": "⚠️ This PDF file has a structural error or does not exist on the system."
-  },
-  "themeModal": {
-    "title": "Theme Settings",
-    "themeSectionTitle": "Theme Color",
-    "themeSectionDesc": "Choose a color to change the look and feel of your conversation.",
-    "customColorTitle": "Custom Color",
-    "doneButton": "Done",
-    "resetButton": "Reset"
-  },
-  "contactList": {
-    "title": "Member List",
-    "searchPlaceholder": "Find member",
-    "sortAsc": "Name (A-Z)",
-    "sortDesc": "Name (Z-A)",
-    "filterAll": "All",
-    "filterOnline": "Online",
-    "filterOffline": "Offline",
-    "role": "Employee"
-  },
-  "groupList": {
-    "title": "Groups & Communities",
-    "searchPlaceholder": "Find group",
-    "members": "members",
-    "createGroup": "Create New Group"
-  },
-  "messageFiles": {
-    "pdfDownloadError": "Failed to download PDF file"
-  },
-  "messageItem": {
-    "actionFailed": "Action failed, please try again!",
-    "linkLabel": "Link"
-  },
-  "messageList": {
-    "loading": "Loading..."
-  },
-  "settingSection": {
-    "themeTitle": "Theme Settings",
-    "saveButton": "Save",
-    "themeCard": "Theme",
-    "lightMode": "Light",
-    "darkMode": "Dark",
-    "colorThemeCard": "Theme Color",
-    "chatBubbleCard": "Chat Bubble",
-    "dragDropToggleLabel": "Allow drag and drop popup",
-    "dragDropToggleDesc": "When enabled, you can drag the title bar to move the chat window to any position.",
-    "Blue": "Blue",
-    "Purple": "Purple",
-    "Pink": "Pink",
-    "Red": "Red",
-    "Orange": "Orange",
-    "Green": "Green",
-    "Gray": "Gray",
-    "saveSuccess": "Configuration saved successfully!",
-    "accountSetting": "Account Settings",
-    "chatLiveTitle": "ChatLive",
-    "chatLiveInfoTitle": "Your Chat Account",
-    "chatLiveInfoDesc": "This account is synchronized from your company's management system.",
-    "company": "Company",
-    "companyCode": "Company Code",
-    "employee": "Employee",
-    "phoneNumber": "Phone Number",
-    "email": "Email",
-    "chatLiveAccessTitle": "Access ChatLive Web/App",
-    "chatLiveAccessDesc": "Quick access to Chatlive on the browser",
-    "chatLiveAccessBtn": "Open ChatLive"
-  },
-  "supportFormModal": {
-    "title": "Support Information",
-    "description": "Please provide your information so we can assist you better",
-    "descriptionFooter": "By clicking 'Submit', you agree to comply with our privacy policy and terms of use.",
-    "fullNameLabel": "Full Name",
-    "fullNamePlaceholder": "Enter your full name",
-    "phoneNumberLabel": "Phone Number",
-    "phoneNumberPlaceholder": "Enter your phone number",
-    "optional": "(Optional)",
-    "submitButton": "Submit",
-    "cancelButton": "Cancel",
-    "submitting": "Submitting...",
-    "successMessage": "Support form submitted successfully!",
-    "errorMessage": "Failed to submit support form. Please try again.",
-    "closeButton": "Close"
-  },
-  "onboarding": {
-    "submitSuccess": "Information submitted successfully",
-    "loadingScript": "System is loading the script, please try again later...",
-    "invalidConfigScript": "Script configuration error: State not found."
-  }
-}
-;
-
-export default _default;