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

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

@@ -0,0 +1,74 @@
+export interface AuthInfo {
+    code?: string;
+    name: string;
+    avatar?: string;
+    phone?: string;
+    email?: string;
+}
+/**
+ * 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).
+ */
+export type WidgetScope = 'external' | 'internal';
+export type WidgetRole = 'guest' | 'admin' | 'member';
+/**
+ * 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.
+ */
+export interface PositionType {
+    right: number;
+    bottom: number;
+}
+/** Các loại định dạng tập tin được phép đính kèm từ thiết bị */
+export type AttachmentType = 'image' | 'video' | 'audio' | 'file' | 'multiple';
+/** Các tùy chọn ngôn ngữ hiển thị trên giao diện */
+export type LanguageOption = 'english' | 'vietnamese';
+/**
+ * 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.
+ */
+export type CommunicationFeature = 'voice';
+/**
+ * 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.
+ */
+export 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ổ.
+ */
+export type WidgetCustomizationOptions = 'change-color' | 'change-theme' | 'drag-and-drop' | 'resize-window';
+export 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[];
+}
+export interface ChatWidgetProps {
+    scope?: WidgetScope;
+    title?: string;
+    workspace?: string;
+    logoUrl?: string;
+    primaryColor?: string;
+    auth: AuthInfo;
+    chatKey: string;
+    features?: WidgetFeature;
+    language?: LanguageOption;
+    initPosition?: PositionType;
+    disabledMembers?: string[];
+}

package/dist/src/utils/chat.utils.d.ts

@@ -0,0 +1,30 @@
+import { AttachmentType, AuthInfo, ChatConversation, ChatUser, CommunicationFeature, WidgetChatMode, WidgetCustomizationOptions, WidgetRole, WidgetScope } from '../../types';
+export declare const getChatName: (chat?: ChatConversation | null, currentUserId?: number, fallback?: string) => string;
+export declare const getRoleSystem: (scope?: WidgetScope, auth?: AuthInfo) => WidgetRole;
+export interface FeatureSet {
+    attachments: Set<AttachmentType>;
+    communication: Set<CommunicationFeature>;
+    chatModes: Set<WidgetChatMode>;
+    customizations: Set<WidgetCustomizationOptions>;
+}
+export declare const getAcceptFilter: (featureSet: FeatureSet) => string;
+export declare const createFileTypeChecker: (featureSet: FeatureSet) => (file: File) => boolean;
+export declare const isConnected: (socketAt: string | undefined) => boolean;
+export declare const addSocketToMap: (memberSocketMap: Record<string, string[]>, memberId: string | number, // Chấp nhận cả string và number cho key
+socketId: string | undefined) => void;
+export declare const transformMember: (member: ChatUser, memberSocketMap: Record<string, string[]>, disconnectedSockets: Record<string, boolean>) => {
+    socket_id: string | undefined;
+    socket_at: string | undefined;
+    id: number;
+    code: string;
+    name: string;
+    avatar?: string;
+    phone?: string;
+    email: string;
+    last_read_id?: number;
+};
+export declare const getContrastColor: (hex: string) => "#ffffff" | "#1e293b";
+export declare const generateGuestCode: () => string;
+export declare const getChatTimestamp: (chat: ChatConversation) => number;
+export declare const sortChatsByRecency: (chats: ChatConversation[] | undefined) => ChatConversation[];
+export declare const calculateTotalUnread: (chats: ChatConversation[], currentUserId: number) => number;

package/dist/src/utils/engine.utils.d.ts

@@ -0,0 +1,5 @@
+import { DeepData } from '../../types';
+export declare const interpolateString: <T extends DeepData>(template: string, data: T) => string;
+export declare const PHONE_REGEX: RegExp;
+export declare const EMAIL_REGEX: RegExp;
+export declare const evaluateCondition: (rule: string, value: unknown, input: string) => boolean;

package/dist/src/utils/file.utils.d.ts

@@ -0,0 +1,18 @@
+import { CSSProperties } from 'react';
+export declare const getFileKey: (file: File) => string | undefined;
+export declare const formatFileSize: (bytes: number) => string;
+export declare const getFileType: (fileName: string) => "image" | "video" | "audio" | "pdf" | "other";
+export declare const getFileExt: (fileName: string) => string;
+export declare const getImagePreview: (file: File) => string;
+export declare const isImageFile: (file: File) => boolean;
+export declare const isAudioFile: (file: File) => boolean;
+export declare const getAudioPreview: (file: File) => string;
+export declare const sortFilesByType: (files: File[]) => File[];
+export declare const sanitizeImage: (file: File) => Promise<File>;
+export declare const getFilesValidationError: (files: File[], hasMultipleAttachments: boolean, isFileTypeAllowed: (file: File) => boolean) => Promise<{
+    message: string;
+    type: "warning" | "error";
+} | null>;
+export declare const validateFileContent: (file: File) => Promise<boolean>;
+export declare const validateFileUrlContent: (url: string, type: string) => Promise<boolean>;
+export declare function getImageRatioStyleFromLink(imgUrl: string): Promise<CSSProperties>;

package/dist/src/utils/format.utils.d.ts

@@ -0,0 +1,7 @@
+import { LanguageOption } from '../../types';
+export declare const formatDuration: (ms: number) => string;
+export declare const removeVietnameseTones: (str: string) => string;
+export declare const formatToDateTimeString: (dateInput: string | number | Date) => string;
+export declare const getCleanTitle: (url: string) => string | null;
+export declare const formatMessageTime: (dateInput: Date, language: LanguageOption) => string;
+export declare const formatMessageDateShort: (dateInput: Date, language: LanguageOption) => string;

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

@@ -0,0 +1,7 @@
+export * from './chat.utils';
+export * from './format.utils';
+export * from './voice.utils';
+export * from './file.utils';
+export * from './validate.utils';
+export * from './text.utils';
+export * from './engine.utils';

package/dist/src/utils/text.utils.d.ts

@@ -0,0 +1 @@
+export declare const highlightText: (text: string, query: string) => string | import("react/jsx-runtime").JSX.Element;

package/dist/src/utils/validate.utils.d.ts

@@ -0,0 +1 @@
+export declare const isStandardUrl: (urlString: string) => boolean;

package/dist/src/utils/voice.utils.d.ts

@@ -0,0 +1 @@
+export declare const convertToMp3: (blob: Blob) => Promise<Blob>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satek-team-intern/chatbot-widget",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "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",
@@ -18,17 +18,19 @@
   "publishConfig": {
     "access": "public"
   },
-  "types": "./dist/index.d.ts",
+  "types": "./dist/src/index.d.ts",
   "scripts": {
     "dev": "vite",
-    "build": "vite build",
+    "build": "npm run build:es && npm run build:umd",
+    "build:es": "cross-env VITE_TARGET_FORMAT=es vite build",
+    "build:umd": "cross-env VITE_TARGET_FORMAT=umd vite build",
     "lint": "eslint --fix",
     "prepare": "husky",
-    "prepublishOnly": "npm run lint && npm run build"
+    "prepublishOnly": "npm run lint && npx tsc --noEmit && npm run build"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/chatbot-widget.es.js",
       "require": "./dist/chatbot-widget.umd.js"
     }