@vezlo/assistant-chat 1.4.0 → 1.6.0

package/PACKAGE_README.md

@@ -4,6 +4,8 @@
 
 A React component library for integrating AI assistant chat functionality into web applications with realtime updates and human agent support.
 
+**📋 [Changelog](https://github.com/vezlo/assistant-chat/blob/main/CHANGELOG.md)** | **🐛 [Report Issue](https://github.com/vezlo/assistant-chat/issues)**
+
 > **📦 This is the NPM package documentation**  
 > **🏠 Repository**: [assistant-chat](https://github.com/vezlo/assistant-chat) - Contains both this NPM package and a standalone admin application  
 > **🖥️ Standalone App**: Want to run the admin dashboard? Visit the [main repository](https://github.com/vezlo/assistant-chat) for setup instructions

package/README.md

@@ -4,6 +4,8 @@
 
 A complete chat widget solution with both a React component library and standalone admin application for AI-powered customer support.
 
+**📋 [Changelog](./CHANGELOG.md)** | **🐛 [Report Issue](https://github.com/vezlo/assistant-chat/issues)**
+
 ## What's Included
 
 ### 📦 NPM Package

package/lib/api/analytics.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Analytics API Service
+ * Handles fetching company analytics data
+ */
+export interface CompanyAnalyticsResponse {
+    conversations: {
+        total: number;
+        open: number;
+        closed: number;
+    };
+    users: {
+        total_active_users: number;
+    };
+    messages: {
+        total: number;
+        user_messages_total: number;
+        assistant_messages_total: number;
+        agent_messages_total: number;
+    };
+    feedback: {
+        total: number;
+        likes: number;
+        dislikes: number;
+    };
+}
+export declare function getCompanyAnalytics(token: string, apiUrl?: string): Promise<CompanyAnalyticsResponse>;

package/lib/api/analytics.js

@@ -0,0 +1,26 @@
+/**
+ * Analytics API Service
+ * Handles fetching company analytics data
+ */
+const DEFAULT_API_BASE_URL = import.meta.env.VITE_ASSISTANT_SERVER_URL || 'http://localhost:3000';
+const parseErrorMessage = async (response) => {
+    const data = await response.json().catch(() => ({}));
+    return (data.error ||
+        data.message ||
+        'Unexpected server error');
+};
+export async function getCompanyAnalytics(token, apiUrl) {
+    const API_BASE_URL = apiUrl || DEFAULT_API_BASE_URL;
+    const response = await fetch(`${API_BASE_URL}/api/company/analytics`, {
+        method: 'GET',
+        headers: {
+            Accept: 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+    });
+    if (!response.ok) {
+        const message = await parseErrorMessage(response);
+        throw new Error(message);
+    }
+    return (await response.json());
+}

package/lib/api/conversation.d.ts

@@ -21,6 +21,7 @@ export interface ConversationListItem {
     last_message_at: string | null;
     joined_at: string | null;
     closed_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -64,7 +65,7 @@ export declare function getConversation(uuid: string, apiUrl?: string): Promise<
 /**
  * Get paginated conversations for agent UI
  */
-export declare function getConversations(token: string, page?: number, pageSize?: number, orderBy?: string, apiUrl?: string): Promise<ConversationListResponse>;
+export declare function getConversations(token: string, page?: number, pageSize?: number, orderBy?: string, apiUrl?: string, status?: 'active' | 'archived'): Promise<ConversationListResponse>;
 /**
  * Get messages within a conversation
  */
@@ -77,6 +78,13 @@ export declare function joinConversation(token: string, conversationUuid: string
  * Close a conversation as an agent
  */
 export declare function closeConversation(token: string, conversationUuid: string, apiUrl?: string): Promise<JoinConversationResponse>;
+/**
+ * Archive a conversation as an agent
+ */
+export declare function archiveConversation(token: string, conversationUuid: string, apiUrl?: string): Promise<{
+    success: boolean;
+    archived_at: string;
+}>;
 /**
  * Send agent-authored message
  */

package/lib/api/conversation.js

@@ -61,9 +61,10 @@ export async function getConversation(uuid, apiUrl) {
 /**
  * Get paginated conversations for agent UI
  */
-export async function getConversations(token, page = 1, pageSize = 20, orderBy = 'last_message_at', apiUrl) {
+export async function getConversations(token, page = 1, pageSize = 20, orderBy = 'last_message_at', apiUrl, status) {
     const API_BASE_URL = apiUrl || DEFAULT_API_BASE_URL;
-    const response = await fetch(`${API_BASE_URL}/api/conversations?page=${page}&page_size=${pageSize}&order_by=${orderBy}`, {
+    const statusParam = status ? `&status=${status}` : '';
+    const response = await fetch(`${API_BASE_URL}/api/conversations?page=${page}&page_size=${pageSize}&order_by=${orderBy}${statusParam}`, {
         method: 'GET',
         headers: {
             Accept: 'application/json',
@@ -130,6 +131,24 @@ export async function closeConversation(token, conversationUuid, apiUrl) {
     }
     return (await response.json());
 }
+/**
+ * Archive a conversation as an agent
+ */
+export async function archiveConversation(token, conversationUuid, apiUrl) {
+    const API_BASE_URL = apiUrl || DEFAULT_API_BASE_URL;
+    const response = await fetch(`${API_BASE_URL}/api/conversations/${conversationUuid}/archive`, {
+        method: 'POST',
+        headers: {
+            Accept: 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+    });
+    if (!response.ok) {
+        const message = await parseErrorMessage(response);
+        throw new Error(message);
+    }
+    return (await response.json());
+}
 /**
  * Send agent-authored message
  */

package/lib/api/index.d.ts

@@ -5,3 +5,4 @@
 export * from './auth.js';
 export * from './conversation.js';
 export * from './message.js';
+export * from './analytics.js';

package/lib/api/index.js

@@ -5,3 +5,4 @@
 export * from './auth.js';
 export * from './conversation.js';
 export * from './message.js';
+export * from './analytics.js';

package/lib/services/conversationRealtime.d.ts

@@ -13,6 +13,7 @@ export interface MessageCreatedPayload {
         joined_at?: string;
         status?: string;
         closed_at?: string;
+        archived_at?: string;
     };
 }
 export interface ConversationCreatedPayload {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vezlo/assistant-chat",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "React component library for AI-powered chat widgets with RAG knowledge base integration, realtime updates, and human agent support",
   "type": "module",
   "main": "lib/index.js",