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

package/dist/src/store/slices/chatSlice.d.ts

@@ -0,0 +1,128 @@
+import { ChatUser, ChatConversation, ChatMessage, PaginationInfo, UseChatOptions } from '../../../types';
+export interface AccountChatState {
+    currentUser: ChatUser | null;
+    chats: ChatConversation[];
+    currentChat?: ChatConversation | null;
+    currentChatMessages: ChatMessage[];
+    currentReceiver?: ChatUser | null;
+    currentChatMembers: ChatUser[];
+    members: ChatUser[];
+    totalMessagesUnread: number;
+    messagesPagination: PaginationInfo | null;
+    replyingMessage: ChatMessage | null;
+    disabledMembers: Record<string, boolean>;
+    memberSocketMap: Record<number, string[]>;
+    disconnectedSockets: Record<string, boolean>;
+    selectedUserProfile: ChatUser | null;
+}
+export interface ChatState {
+    accounts: Record<string, AccountChatState>;
+    activeAccountCode?: string;
+    defaultAccountCode?: string;
+    accountConfigs: UseChatOptions[];
+}
+export declare const defaultAccountState: AccountChatState;
+export declare const setDefaultAccount: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/setDefaultAccount">, setActiveAccount: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/setActiveAccount">, registerAccountConfig: import('@reduxjs/toolkit').ActionCreatorWithPayload<UseChatOptions, "widget-chatslice/registerAccountConfig">, removeAccountConfig: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/removeAccountConfig">, initAccountState: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/initAccountState">, clearAccount: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/clearAccount">, removeAccountState: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+}, "widget-chatslice/removeAccountState">, setCurrentUser: import('@reduxjs/toolkit').ActionCreatorWithPayload<ChatUser | null, "widget-chatslice/setCurrentUser">, setChats: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chats: ChatConversation[];
+}, "widget-chatslice/setChats">, setCurrentChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat: ChatConversation | null;
+}, "widget-chatslice/setCurrentChat">, setCurrentChatMessages: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    messages: ChatMessage[];
+}, "widget-chatslice/setCurrentChatMessages">, setCurrentChatMembers: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    members: ChatUser[];
+}, "widget-chatslice/setCurrentChatMembers">, setMembers: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    members: ChatUser[];
+}, "widget-chatslice/setMembers">, setDisabledMembers: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    disabledMembers: string[];
+}, "widget-chatslice/setDisabledMembers">, setMember: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    member: ChatUser;
+    timestamp: number;
+    socketId: string;
+}, "widget-chatslice/setMember">, setMemberDisconnect: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    socketId: string;
+}, "widget-chatslice/setMemberDisconnect">, setMessagesPagination: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    pagination?: PaginationInfo;
+}, "widget-chatslice/setMessagesPagination">, prependMessages: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    messages: ChatMessage[];
+}, "widget-chatslice/prependMessages">, addNewMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat: ChatConversation;
+    message: ChatMessage;
+}, "widget-chatslice/addNewMessage">, addNewSystemMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    message: ChatMessage;
+}, "widget-chatslice/addNewSystemMessage">, removeChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chatId: number;
+}, "widget-chatslice/removeChat">, addChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat: ChatConversation;
+}, "widget-chatslice/addChat">, updateChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat: ChatConversation;
+}, "widget-chatslice/updateChat">, updateChatAvatar: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chatId: number;
+    avatar: string;
+}, "widget-chatslice/updateChatAvatar">, removeMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat_id: number;
+    message_id: number;
+    type: "remove" | "revoke";
+}, "widget-chatslice/removeMessage">, updateMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chat_id: number;
+    message: ChatMessage;
+}, "widget-chatslice/updateMessage">, setReplyingMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    message: ChatMessage | null;
+}, "widget-chatslice/setReplyingMessage">, setTotalMessagesUnread: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    total: number;
+}, "widget-chatslice/setTotalMessagesUnread">, updateMemberReadStatus: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chatId: number;
+    memberId: number;
+    lastReadId: number;
+}, "widget-chatslice/updateMemberReadStatus">, toggleChatSetting: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    chatId: number;
+    setting: "is_muted" | "is_pined";
+}, "widget-chatslice/toggleChatSetting">, renewMemberActivity: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    userId: number;
+}, "widget-chatslice/renewMemberActivity">, memberJoinChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    member: ChatUser;
+    chat: ChatConversation;
+}, "widget-chatslice/memberJoinChat">, memberLeaveChat: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    member_id: number;
+    chat: ChatConversation;
+}, "widget-chatslice/memberLeaveChat">, setSelectedUserProfile: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    accountCode: string;
+    userProfile: ChatUser | null;
+}, "widget-chatslice/setSelectedUserProfile">;
+export declare const chatReducer: import('redux').Reducer<ChatState>;

package/dist/src/store/slices/index.d.ts

@@ -0,0 +1,4 @@
+export * from './chatSlice';
+export * from './settingSlice';
+export * from './layoutSlice';
+export * from './onboardingSlice';

package/dist/src/store/slices/layoutSlice.d.ts

@@ -0,0 +1,12 @@
+import { PositionWidget, WidgetChatTab, WidgetMode, WidgetSize, WidgetSubChatTab } from '../../../types';
+export interface LayoutState {
+    mode: WidgetMode;
+    isChatLoading: boolean;
+    activeChatTab: WidgetChatTab;
+    activeSubChatTab: WidgetSubChatTab;
+    dragPosition: PositionWidget;
+    fullpagePosition: PositionWidget;
+    fullpageSize: WidgetSize;
+}
+export declare const setIsChatLoading: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setIsChatLoading">, setActiveChatTab: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setActiveChatTab">, setWidgetMode: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setWidgetMode">, setDragPosition: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setDragPosition">, setFullpagePosition: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setFullpagePosition">, setFullpageSize: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-layoutslice/setFullpageSize">, setActiveSubChatTab: import('@reduxjs/toolkit').ActionCreatorWithPayload<WidgetSubChatTab, "widget-layoutslice/setActiveSubChatTab">;
+export declare const layoutReducer: import('redux').Reducer<LayoutState>;

package/dist/src/store/slices/onboardingSlice.d.ts

@@ -0,0 +1,15 @@
+import { ChatMessage, MetadataOptions, OnboardingConfigJSON, OnboardingData } from '../../../types';
+export interface OnboardingState {
+    onboardingState: string;
+    data: OnboardingData;
+    messages: ChatMessage[];
+    currentGuestCode: string;
+    config: OnboardingConfigJSON | null;
+}
+export declare const resetOnboarding: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"widget-onboardingSlice/resetOnboarding">, setCurrentGuestCode: import('@reduxjs/toolkit').ActionCreatorWithPayload<string, "widget-onboardingSlice/setCurrentGuestCode">, updateOnboarding: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    botReply: string;
+    nextState: string;
+    updatedData: OnboardingData;
+    metadata?: MetadataOptions;
+}, "widget-onboardingSlice/updateOnboarding">, addOnboardingMessage: import('@reduxjs/toolkit').ActionCreatorWithPayload<string, "widget-onboardingSlice/addOnboardingMessage">, updateOnboardingState: import('@reduxjs/toolkit').ActionCreatorWithPayload<string, "widget-onboardingSlice/updateOnboardingState">, finishOnboarding: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"widget-onboardingSlice/finishOnboarding">, markMessageAsAnswered: import('@reduxjs/toolkit').ActionCreatorWithPayload<number, "widget-onboardingSlice/markMessageAsAnswered">, setOnboardingConfig: import('@reduxjs/toolkit').ActionCreatorWithPayload<OnboardingConfigJSON, "widget-onboardingSlice/setOnboardingConfig">;
+export declare const onboardingReducer: import('redux').Reducer<OnboardingState>;

package/dist/src/store/slices/settingSlice.d.ts

@@ -0,0 +1,16 @@
+import { LanguageOption, WidgetFeature, WidgetRole } from '../../../types';
+export interface SettingState {
+    theme: 'light' | 'dark';
+    primaryColor: string;
+    features: WidgetFeature;
+    currentLanguage: LanguageOption;
+    hasMultipleLanguages: boolean;
+    draggable: boolean;
+    role: WidgetRole;
+}
+export declare const setConfig: import('@reduxjs/toolkit').ActionCreatorWithPayload<{
+    features?: WidgetFeature;
+    language?: LanguageOption;
+    role?: WidgetRole;
+}, "widget-settingslice/setConfig">, setTheme: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-settingslice/setTheme">, setFeatures: import('@reduxjs/toolkit').ActionCreatorWithPayload<WidgetFeature, "widget-settingslice/setFeatures">, setPrimaryColor: import('@reduxjs/toolkit').ActionCreatorWithPayload<any, "widget-settingslice/setPrimaryColor">, setDraggable: import('@reduxjs/toolkit').ActionCreatorWithPayload<boolean, "widget-settingslice/setDraggable">, setLanguage: import('@reduxjs/toolkit').ActionCreatorWithPayload<LanguageOption, "widget-settingslice/setLanguage">;
+export declare const settingReducer: import('redux').Reducer<SettingState>;

package/dist/src/store/store.d.ts

@@ -0,0 +1,20 @@
+import { Tuple, AnyAction, ThunkDispatch, UnknownAction, EnhancedStore, StoreEnhancer } from '@reduxjs/toolkit';
+import { ChatState, SettingState, LayoutState, OnboardingState } from '../../store/slices';
+export declare const store: EnhancedStore<{
+    chat: ChatState;
+    setting: SettingState;
+    layout: LayoutState;
+    onboarding: OnboardingState;
+}, AnyAction, Tuple<[
+    StoreEnhancer<{
+        dispatch: ThunkDispatch<{
+            chat: ChatState;
+            setting: SettingState;
+            layout: LayoutState;
+            onboarding: OnboardingState;
+        }, undefined, UnknownAction>;
+    }>,
+    StoreEnhancer
+]>>;
+export type RootState = ReturnType<typeof store.getState>;
+export type AppDispatch = typeof store.dispatch;

package/dist/src/types/chat.type.d.ts

@@ -0,0 +1,370 @@
+import { AuthInfo, WidgetScope } from '../../types';
+export interface UseChatOptions {
+    chatKey: string;
+    authInfo: AuthInfo;
+    scope?: WidgetScope;
+    workspace?: string;
+    disabledMembers?: string[];
+    isPrimary?: boolean;
+}
+export interface ChatUser {
+    id: number;
+    code: string;
+    name: string;
+    avatar?: string;
+    phone?: string;
+    email: string;
+    socket_at?: string;
+    socket_id?: string;
+    last_read_id?: number;
+}
+export interface ChatResponse<T = unknown> {
+    data?: T;
+    message?: string;
+    statusCode?: number;
+    statusText?: string;
+    [key: string]: unknown;
+}
+export type FormFieldType = 'text' | 'tel' | 'email' | 'radio' | 'select';
+export interface FormFieldOption {
+    label: string;
+    value: string;
+}
+export interface FormFieldValidation {
+    rule: string;
+    value?: number | string;
+    error_message: string;
+}
+export interface FormField {
+    save_variable: string;
+    label: string;
+    type: FormFieldType;
+    placeholder?: string;
+    required: boolean;
+    options?: FormFieldOption[];
+    validation?: FormFieldValidation;
+}
+interface BaseMetadata {
+    isAnswered: boolean;
+}
+interface ButtonMetadata extends BaseMetadata {
+    type: 'quick_reply' | 'interactive_input';
+    actions: MetadataActions[];
+}
+interface FormMetadata extends BaseMetadata {
+    type: 'form_input';
+    submit_button_label?: string;
+    fields: FormField[];
+}
+export type MetadataOptions = ButtonMetadata | FormMetadata;
+export interface MetadataActions {
+    id: string;
+    label: string;
+    value: string;
+}
+export interface SystemMessageContent {
+    data: {
+        code: string;
+    };
+    name: string;
+    type: 'live';
+}
+export type MessageContentType = string | SystemMessageContent | null;
+export interface ChatMessage {
+    id: number;
+    type: 'text' | 'json' | 'html';
+    action: Record<string, number>;
+    member: ChatUser;
+    content: MessageContentType;
+    files?: ChatFile[];
+    revoked: boolean;
+    removed: boolean;
+    date: string;
+    reply?: ChatMessage | null;
+    created_at: string;
+    updated_at: string;
+    [key: string]: unknown;
+    metadata?: MetadataOptions;
+}
+export interface ChatConversation {
+    id: number;
+    code: string;
+    name?: string;
+    type: 'single' | 'group';
+    avatar?: string | null;
+    message: ChatMessage | null;
+    members?: ChatUser[];
+    new: Record<number, number>;
+    owner_id?: number;
+    updated_at: string;
+    create_at: string;
+    is_muted?: boolean;
+    is_pined?: boolean;
+    member?: number;
+    [key: string]: unknown;
+}
+export interface ChatEvent {
+    system_message: 'system.messages';
+    chats_created: 'chats.created';
+    chats_updated: 'chats.updated';
+    chats_deleted: 'chats.deleted';
+    chats_member: 'chats.member';
+    chats_action: 'chats.action';
+    chats_message: 'chats.message';
+    members_connect: 'members.connect';
+    members_disconnect: 'members.disconnect';
+    new_message: 'new_message';
+}
+export interface ChatFile {
+    id: number;
+    name: string;
+    ext: string;
+    size: number;
+    link: string;
+}
+export interface ChatConfig {
+    debugMode?: boolean;
+    maxRetries?: number;
+    [key: string]: unknown;
+}
+export type ChatDurationUnit = 'minutes' | 'hours' | 'days';
+export interface ChatSetting {
+    allow_delete_chat: boolean;
+    allow_delete_message: boolean;
+    allow_revoke_message: boolean;
+    delete_duration: number;
+    delete_duration_unit: ChatDurationUnit;
+    revoke_duration: number;
+    revoke_duration_unit: ChatDurationUnit;
+    project_id: number;
+    project_code: string;
+    project_name: string;
+    workspace: string;
+}
+export type MessageAction = 'like' | 'love' | 'revoke' | 'remove';
+export interface PaginationInfo {
+    count: number;
+    current_page: number;
+    per_page: number;
+    total: number;
+    total_pages: number;
+}
+export interface ChatEventPayloads {
+    'system.messages': {
+        message: ChatMessage;
+        type: 'add';
+    };
+    'chats.created': {
+        chat: ChatConversation;
+    };
+    'chats.updated': {
+        chat: ChatConversation;
+    };
+    'chats.deleted': {
+        chat_id: number;
+    };
+    'chats.member': {
+        type: 'join' | 'leave';
+        chat?: ChatConversation;
+        chat_id?: number;
+        member?: ChatUser;
+        member_id?: number;
+    };
+    'chats.action': {
+        chat_id?: number;
+        message_id?: number;
+        action?: MessageAction;
+        user_id?: number;
+        chat?: ChatConversation;
+        member_id?: number;
+        type: 'read' | 'unread';
+    };
+    'chats.message': {
+        chat: ChatConversation;
+        message: ChatMessage;
+        type: 'add' | 'remove' | 'revoke' | 'like' | 'love';
+        chat_id: number;
+        message_id: number;
+    };
+    'members.connect': {
+        member: ChatUser;
+        socketId: string;
+        timestamp: number;
+    };
+    'members.disconnect': {
+        socketId: string;
+    };
+    new_message: {
+        new: number;
+    };
+}
+export interface ChatInstance {
+    /**
+     * Thuộc tính setting trả về cấu hình hiện tại của SDK, bao gồm các quyền hạn và giới hạn như allow_delete_chat, delete_duration...
+     */
+    setting: ChatSetting;
+    /**
+     * Thiết lập cấu hình tùy chỉnh cho SDK.
+     * @param config (Object): Các tùy chọn cấu hình như debugMode, maxRetries...
+     */
+    setConfig(config: ChatConfig): void;
+    /**
+     * Thiết lập thông tin xác thực cho SDK.
+     * @param data Thông tin người dùng hiện tại
+     */
+    setAuth(data: AuthInfo): Promise<ChatUser>;
+    /**
+     * Lấy thông tin xác thực hiện tại.
+     */
+    getAuth(): ChatUser | null;
+    /**
+     * Xóa thông tin xác thực.
+     */
+    clearAuth(): void;
+    /**
+     * Thiết lập thông tin người nhận.
+     * @param data Thông tin người nhận
+     */
+    setReceiver(data: ChatUser): Promise<ChatResponse<ChatUser>>;
+    /**
+     * Lấy thông tin người nhận hiện tại.
+     */
+    getReceiver(): ChatUser | null;
+    /**
+     * Xóa thông tin người nhận.
+     */
+    clearReceiver(): void;
+    /**
+     * Lấy danh sách thành viên
+     * @param chatId ID cuộc trò chuyện (tùy chọn, mặc định null lấy tất cả)
+     * @param limit Số lượng bản ghi (tùy chọn, mặc định 0 lấy tất cả)
+     * @param page Số trang (tùy chọn, mặc định 1)
+     * @param include Các trường bổ sung (tùy chọn)
+     */
+    getMembers(chatId?: number | null, limit?: number, page?: number, include?: string): Promise<ChatResponse<ChatUser[]>>;
+    /**
+     * Thêm thành viên vào nhóm.
+     * @param chatId ID cuộc trò chuyện.
+     * @param memberId ID thành viên cần thêm.
+     */
+    addMember(chatId: number, memberId: number): Promise<ChatResponse>;
+    /**
+     * Xóa thành viên khỏi nhóm hoặc rời nhóm.
+     * Lưu ý: Nếu xóa chính mình, nhóm sẽ bị xóa hoàn toàn.
+     * @param chatId ID cuộc trò chuyện (Number)
+     * @param memberId ID thành viên cần xóa (Number)
+     */
+    removeMember(chatId: number, memberId: number): Promise<ChatResponse>;
+    /**
+     * Lấy danh sách cuộc trò chuyện của thành viên hiện tại.
+     * @param limit Số lượng bản ghi (tùy chọn, mặc định 0 = tất cả)
+     * @param page Số trang (tùy chọn, mặc định 1)
+     */
+    getChats(limit?: number, page?: number): Promise<ChatResponse<ChatConversation[]> & {
+        pagination?: PaginationInfo;
+    }>;
+    /**
+     * Tìm cuộc trò chuyện 1-1 với một người nhất định.
+     * @param receiverId ID người nhận (Number)
+     * @returns Promise trả về object cuộc trò chuyện (ChatConversation) hoặc null
+     */
+    findChatByReceiver(receiverId: number | string): Promise<ChatConversation | undefined>;
+    /**
+     * Tạo cuộc trò chuyện 1-1 hoặc lấy cuộc trò chuyện cũ nếu đã tồn tại.
+     * @param receiverId ID người nhận (Number, bắt buộc)
+     * @param content Tin nhắn đầu tiên (String, tùy chọn)
+     */
+    addChat(receiverId: number, content?: string): Promise<ChatResponse<ChatConversation>>;
+    /**
+     * Tạo nhóm trò chuyện mới.
+     * @param memberIds Danh sách ID thành viên (ít nhất 2 thành viên khác)
+     * @param name Tên nhóm
+     * @param avatar URL ảnh đại diện nhóm (tùy chọn)
+     * @param userId ID người dùng tạo nhóm (tùy chọn)
+     * @returns Promise trả về object nhóm (ChatConversation)
+     */
+    addGroup(memberIds: number[], name: string, avatar?: string | File, userId?: number): Promise<ChatResponse<ChatConversation>>;
+    /**
+     * Cập nhật thông tin nhóm (Tên và Ảnh đại diện).
+     * @param chatId ID nhóm (Number, bắt buộc)
+     * @param name Tên nhóm mới (String, bắt buộc)
+     * @param avatar URL ảnh đại diện mới (String, tùy chọn)
+     * @returns Promise trả về object nhóm đã được cập nhật
+     */
+    updateGroup(chatId: number, name: string, avatar?: string | File): Promise<ChatResponse<ChatConversation>>;
+    /**
+     * Xóa một cuộc trò chuyện (chat 1-1 hoặc nhóm).
+     * @param chatId ID cuộc trò chuyện (Number, bắt buộc)
+     * @returns Promise trả về kết quả thành công/thất bại
+     */
+    removeChat(chatId: number): Promise<ChatResponse>;
+    /**
+     * Đánh dấu cuộc trò chuyện là đã đọc.
+     * @param chatId ID cuộc trò chuyện (Number, bắt buộc)
+     * @returns Promise trả về kết quả
+     */
+    readChat(chatId: number): Promise<ChatResponse>;
+    /**
+     * Đánh dấu cuộc trò chuyện là chưa đọc.
+     * @param chatId ID cuộc trò chuyện (Number, bắt buộc)
+     * @returns Promise trả về kết quả
+     */
+    unreadChat(chatId: number): Promise<ChatResponse>;
+    /**
+     * Lấy danh sách tin nhắn trong một cuộc trò chuyện.
+     * @param chatId ID cuộc trò chuyện (Number, bắt buộc)
+     * @param limit Số lượng tin nhắn (Number, tùy chọn, mặc định 20)
+     * @param page Trang (Number, tùy chọn, mặc định 1)
+     */
+    getMessages(chatId: number, limit?: number, page?: number): Promise<ChatResponse<ChatMessage[]> & {
+        pagination?: PaginationInfo;
+    }>;
+    /**
+     * Gửi tin nhắn với nội dung, tập tin, hoặc trả lời tin nhắn khác.
+     * @param chatId ID cuộc trò chuyện (Bắt buộc)
+     * @param content Nội dung văn bản (Bắt buộc nếu không có files)
+     * @param files Danh sách tập tin (FileList hoặc File[])
+     * @param replyId ID tin nhắn cần trả lời
+     */
+    addMessage(chatId: number, content?: string | null, files?: FileList | File[] | null, replyId?: number | null): Promise<ChatResponse<ChatMessage>>;
+    /**
+     * Tương tác với tin nhắn (like, love, revoke, remove).
+     * @param chatId ID cuộc trò chuyện (Number, bắt buộc)
+     * @param messageId ID tin nhắn (Number, bắt buộc)
+     * @param action Kiểu tương tác ('like' | 'love' | 'revoke' | 'remove')
+     * @returns Promise trả về kết quả từ SDK
+     */
+    actionMessage(chatId: number, messageId: number, action: MessageAction): Promise<{
+        message_id: number;
+        member_id: number;
+    }>;
+    /**
+     * Lấy danh sách tin nhắn hệ thống (system messages)
+     * @param limit Số lượng tin nhắn (Number, tùy chọn, mặc định 20)
+     * @param page Trang (Number, tùy chọn, mặc định 1)
+     */
+    getSystemMessages(limit?: number, page?: number): Promise<ChatResponse<ChatMessage[]> & {
+        pagination?: PaginationInfo;
+    }>;
+    EVENTS: ChatEvent;
+    /**
+     * Đăng ký lắng nghe sự kiện realtime
+     * @param event Tên sự kiện (lấy từ chatSDK.EVENTS)
+     * @param listener Hàm callback xử lý dữ liệu trả về
+     */
+    addEventListener<K extends keyof ChatEventPayloads>(event: K, listener: (data: K extends keyof ChatEventPayloads ? ChatEventPayloads[K] : unknown) => void): void;
+    /**
+     * Hủy lắng nghe một sự kiện.
+     * @param event Tên sự kiện (String, bắt buộc)
+     * @param listener Hàm callback cần xóa (Tùy chọn). Nếu không truyền hoặc truyền null, xóa tất cả listeners của sự kiện này.
+     */
+    removeEventListener<K extends keyof ChatEventPayloads>(event: K, listener?: (data: ChatEventPayloads[K]) => void): void;
+    /**
+     * Đẩy một sự kiện cho tất cả listeners (thường dùng cho debug hoặc logic tùy chỉnh).
+     * @param name (String, bắt buộc): Tên sự kiện (lấy từ chatSDK.EVENTS)
+     * @param data (Object): Dữ liệu đi kèm sự kiện
+     */
+    runEvent<K extends keyof ChatEventPayloads>(name: K | string, data?: ChatEventPayloads[K]): void;
+}
+export type ChatConstructor = new (workspace?: string) => ChatInstance;
+export {};

package/dist/src/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './chat.type';
+export * from './types';
+export * from './layout.type';
+export * from './onboarding.type';

package/dist/src/types/layout.type.d.ts

@@ -0,0 +1,13 @@
+export type WidgetMode = 'closed' | 'popup' | 'fullpage';
+export type WidgetChatTab = 'chats' | 'contacts' | 'supports' | 'settings';
+export type WidgetContactTab = 'members' | 'groups';
+export type WidgetSettingTab = 'theme' | 'account' | 'chatlive';
+export type WidgetSubChatTab = '' | WidgetContactTab | WidgetSettingTab;
+export interface PositionWidget {
+    x: number;
+    y: number;
+}
+export interface WidgetSize {
+    width: number;
+    height: number;
+}

package/dist/src/types/onboarding.type.d.ts

@@ -0,0 +1,45 @@
+import { FormField } from './chat.type';
+export type OnboardingData = {
+    name: string;
+} & Record<string, string | undefined>;
+export type Primitive = string | number | boolean | null | undefined;
+export interface DeepData {
+    [key: string]: Primitive | DeepData;
+}
+export interface OnboardingEdgeCase {
+    match_keywords: string[];
+    override_value: string;
+    override_message?: string;
+    next_step: string;
+}
+export interface OnboardingOption {
+    label: string;
+    value: string;
+    next_step: string;
+}
+export interface OnboardingValidation {
+    rule: string;
+    value: string | number | string[];
+    error_message: string;
+}
+export interface OnboardingStepConfig {
+    type: 'text_input' | 'quick_reply' | 'system_action' | 'interactive_input' | 'form_input';
+    save_variable?: keyof OnboardingData | null;
+    bot_message: string;
+    next_step: string;
+    validation?: OnboardingValidation;
+    edge_cases?: OnboardingEdgeCase[];
+    options?: OnboardingOption[];
+    action_name?: string;
+    fields?: FormField[];
+    submit_button_label?: string;
+}
+export interface OnboardingConfigJSON {
+    meta: {
+        version: string;
+        bot_name: string;
+        start_step: string;
+        end_step: string;
+    };
+    steps: Record<string, OnboardingStepConfig>;
+}