@product7/feedback-sdk 1.2.6 → 1.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@product7/feedback-sdk",
-	"version": "1.2.6",
+	"version": "1.2.7",
 	"description": "JavaScript SDK for integrating Product7 feedback widgets into any website",
 	"main": "dist/feedback-sdk.js",
 	"module": "src/index.js",

package/src/core/APIService.js

@@ -79,7 +79,9 @@ const MOCK_CONVERSATIONS = [
 		id: 'conv_2',
 		subject: 'Feature request',
 		status: 'open',
-		last_message_at: new Date(Date.now() - 6 * 24 * 60 * 60 * 1000).toISOString(),
+		last_message_at: new Date(
+			Date.now() - 6 * 24 * 60 * 60 * 1000
+		).toISOString(),
 		created_at: new Date(Date.now() - 10 * 24 * 60 * 60 * 1000).toISOString(),
 		unread: 0,
 		assigned_user: {
@@ -121,11 +123,14 @@ const MOCK_MESSAGES = {
 			id: 'msg_4',
 			content: 'I would love to see a dark mode feature!',
 			sender_type: 'customer',
-			created_at: new Date(Date.now() - 6 * 24 * 60 * 60 * 1000 - 30 * 60 * 1000).toISOString(),
+			created_at: new Date(
+				Date.now() - 6 * 24 * 60 * 60 * 1000 - 30 * 60 * 1000
+			).toISOString(),
 		},
 		{
 			id: 'msg_5',
-			content: "Great suggestion! That feature will be available next week. I'll let you know when it's ready.",
+			content:
+				"Great suggestion! That feature will be available next week. I'll let you know when it's ready.",
 			sender_type: 'agent',
 			sender_name: 'Tom',
 			sender_avatar: null,
@@ -155,7 +160,8 @@ const MOCK_HELP_COLLECTIONS = [
 	{
 		id: 'collection_3',
 		title: 'AI Agent',
-		description: 'Resolving customer questions instantly and accurately—from live chat to email.',
+		description:
+			'Resolving customer questions instantly and accurately—from live chat to email.',
 		articleCount: 82,
 		icon: 'ph-robot',
 		url: '#',
@@ -163,7 +169,8 @@ const MOCK_HELP_COLLECTIONS = [
 	{
 		id: 'collection_4',
 		title: 'Channels',
-		description: 'Enabling the channels you use to communicate with customers, all from the Inbox.',
+		description:
+			'Enabling the channels you use to communicate with customers, all from the Inbox.',
 		articleCount: 45,
 		icon: 'ph-chat-circle',
 		url: '#',
@@ -710,10 +717,13 @@ export class APIService {
 			};
 		}
 
-		return this._makeRequest(`/widget/messenger/conversations/${conversationId}`, {
-			method: 'GET',
-			headers: { Authorization: `Bearer ${this.sessionToken}` },
-		});
+		return this._makeRequest(
+			`/widget/messenger/conversations/${conversationId}`,
+			{
+				method: 'GET',
+				headers: { Authorization: `Bearer ${this.sessionToken}` },
+			}
+		);
 	}
 
 	/**
@@ -820,14 +830,17 @@ export class APIService {
 			return { status: true, data: newMessage };
 		}
 
-		return this._makeRequest(`/widget/messenger/conversations/${conversationId}/messages`, {
-			method: 'POST',
-			headers: {
-				'Content-Type': 'application/json',
-				Authorization: `Bearer ${this.sessionToken}`,
-			},
-			body: JSON.stringify({ content: data.content }),
-		});
+		return this._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/messages`,
+			{
+				method: 'POST',
+				headers: {
+					'Content-Type': 'application/json',
+					Authorization: `Bearer ${this.sessionToken}`,
+				},
+				body: JSON.stringify({ content: data.content }),
+			}
+		);
 	}
 
 	/**
@@ -845,14 +858,17 @@ export class APIService {
 			return { status: true };
 		}
 
-		return this._makeRequest(`/widget/messenger/conversations/${conversationId}/typing`, {
-			method: 'POST',
-			headers: {
-				'Content-Type': 'application/json',
-				Authorization: `Bearer ${this.sessionToken}`,
-			},
-			body: JSON.stringify({ is_typing: isTyping }),
-		});
+		return this._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/typing`,
+			{
+				method: 'POST',
+				headers: {
+					'Content-Type': 'application/json',
+					Authorization: `Bearer ${this.sessionToken}`,
+				},
+				body: JSON.stringify({ is_typing: isTyping }),
+			}
+		);
 	}
 
 	/**
@@ -869,10 +885,13 @@ export class APIService {
 			return { status: true };
 		}
 
-		return this._makeRequest(`/widget/messenger/conversations/${conversationId}/read`, {
-			method: 'POST',
-			headers: { Authorization: `Bearer ${this.sessionToken}` },
-		});
+		return this._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/read`,
+			{
+				method: 'POST',
+				headers: { Authorization: `Bearer ${this.sessionToken}` },
+			}
+		);
 	}
 
 	/**
@@ -885,7 +904,10 @@ export class APIService {
 		}
 
 		if (this.mock) {
-			const count = MOCK_CONVERSATIONS.reduce((sum, c) => sum + (c.unread || 0), 0);
+			const count = MOCK_CONVERSATIONS.reduce(
+				(sum, c) => sum + (c.unread || 0),
+				0
+			);
 			return {
 				status: true,
 				data: { unread_count: count, unread_conversations: count > 0 ? 1 : 0 },
@@ -915,17 +937,20 @@ export class APIService {
 			return { status: true, message: 'Thank you for your feedback!' };
 		}
 
-		return this._makeRequest(`/widget/messenger/conversations/${conversationId}/rate`, {
-			method: 'POST',
-			headers: {
-				'Content-Type': 'application/json',
-				Authorization: `Bearer ${this.sessionToken}`,
-			},
-			body: JSON.stringify({
-				rating: data.rating,
-				comment: data.comment || '',
-			}),
-		});
+		return this._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/rate`,
+			{
+				method: 'POST',
+				headers: {
+					'Content-Type': 'application/json',
+					Authorization: `Bearer ${this.sessionToken}`,
+				},
+				body: JSON.stringify({
+					rating: data.rating,
+					comment: data.comment || '',
+				}),
+			}
+		);
 	}
 
 	/**

package/src/core/FeedbackSDK.js

@@ -358,8 +358,10 @@ export class FeedbackSDK {
 		// Check backend tracking first (from init response)
 		if (this.config.last_feedback_at) {
 			try {
-				const backendTimestamp = new Date(this.config.last_feedback_at).getTime();
-				if ((now - backendTimestamp) < cooldownMs) {
+				const backendTimestamp = new Date(
+					this.config.last_feedback_at
+				).getTime();
+				if (now - backendTimestamp < cooldownMs) {
 					return true;
 				}
 			} catch (e) {
@@ -374,7 +376,7 @@ export class FeedbackSDK {
 			if (!stored) return false;
 
 			const data = JSON.parse(stored);
-			return (now - data.submittedAt) < cooldownMs;
+			return now - data.submittedAt < cooldownMs;
 		} catch (e) {
 			return false;
 		}

package/src/core/WebSocketService.js

@@ -208,7 +208,9 @@ export class WebSocketService {
 
 		this.reconnectAttempts++;
 		const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
-		console.log(`[WebSocket] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+		console.log(
+			`[WebSocket] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`
+		);
 
 		setTimeout(() => {
 			this.connect();

package/src/widgets/BaseWidget.js

@@ -52,7 +52,7 @@ export class BaseWidget {
 		if (this.options.suppressAfterSubmission && this._hasRecentlySubmitted()) {
 			this.sdk.eventBus.emit('widget:suppressed', {
 				widget: this,
-				reason: 'recently_submitted'
+				reason: 'recently_submitted',
 			});
 			return this;
 		}
@@ -276,8 +276,10 @@ export class BaseWidget {
 		// Check backend tracking first (from init response)
 		if (this.sdk.config.last_feedback_at) {
 			try {
-				const backendTimestamp = new Date(this.sdk.config.last_feedback_at).getTime();
-				if ((now - backendTimestamp) < cooldownMs) {
+				const backendTimestamp = new Date(
+					this.sdk.config.last_feedback_at
+				).getTime();
+				if (now - backendTimestamp < cooldownMs) {
 					return true;
 				}
 			} catch (e) {
@@ -296,7 +298,7 @@ export class BaseWidget {
 			const data = JSON.parse(stored);
 			const submittedAt = data.submittedAt;
 
-			return (now - submittedAt) < cooldownMs;
+			return now - submittedAt < cooldownMs;
 		} catch (e) {
 			// localStorage may not be available or data is corrupted
 			return false;

package/src/widgets/MessengerWidget.js

@@ -1,6 +1,7 @@
 /**
  * MessengerWidget - Full-featured Messenger/Chat widget
  */
+import { WebSocketService } from '../core/WebSocketService.js';
 import { BaseWidget } from './BaseWidget.js';
 import { MessengerState } from './messenger/MessengerState.js';
 import { MessengerLauncher } from './messenger/components/MessengerLauncher.js';
@@ -10,7 +11,6 @@ import { ChatView } from './messenger/views/ChatView.js';
 import { ConversationsView } from './messenger/views/ConversationsView.js';
 import { HelpView } from './messenger/views/HelpView.js';
 import { HomeView } from './messenger/views/HomeView.js';
-import { WebSocketService } from '../core/WebSocketService.js';
 
 export class MessengerWidget extends BaseWidget {
 	constructor(options) {
@@ -216,7 +216,10 @@ export class MessengerWidget extends BaseWidget {
 		this.messengerState.addMessage(conversation_id, localMessage);
 
 		// Update unread count if panel is closed or viewing different conversation
-		if (!this.messengerState.isOpen || this.messengerState.activeConversationId !== conversation_id) {
+		if (
+			!this.messengerState.isOpen ||
+			this.messengerState.activeConversationId !== conversation_id
+		) {
 			this._updateUnreadCount();
 		}
 	}
@@ -250,7 +253,9 @@ export class MessengerWidget extends BaseWidget {
 			const response = await this.apiService.getUnreadCount();
 			if (response.status && response.data) {
 				this.messengerState.unreadCount = response.data.unread_count || 0;
-				this.messengerState._notify('unreadCountChange', { count: this.messengerState.unreadCount });
+				this.messengerState._notify('unreadCountChange', {
+					count: this.messengerState.unreadCount,
+				});
 			}
 		} catch (error) {
 			console.error('[MessengerWidget] Failed to get unread count:', error);
@@ -424,9 +429,16 @@ export class MessengerWidget extends BaseWidget {
 				// Transform API response to local format
 				return response.data.map((conv) => ({
 					id: conv.id,
-					title: conv.subject || `Chat with ${conv.assigned_user?.name || 'Support'}`,
+					title:
+						conv.subject ||
+						`Chat with ${conv.assigned_user?.name || 'Support'}`,
 					participants: conv.assigned_user
-						? [{ name: conv.assigned_user.name, avatarUrl: conv.assigned_user.avatar }]
+						? [
+								{
+									name: conv.assigned_user.name,
+									avatarUrl: conv.assigned_user.avatar,
+								},
+							]
 						: [{ name: 'Support', avatarUrl: null }],
 					lastMessage: conv.preview || conv.snippet || '',
 					lastMessageTime: conv.last_message_at,
@@ -450,7 +462,8 @@ export class MessengerWidget extends BaseWidget {
 					id: collection.id,
 					title: collection.title || collection.name,
 					description: collection.description || '',
-					articleCount: collection.article_count || collection.articleCount || 0,
+					articleCount:
+						collection.article_count || collection.articleCount || 0,
 					icon: collection.icon || 'ph-book-open',
 					url: collection.url || `#/help/${collection.slug || collection.id}`,
 				}));
@@ -475,7 +488,9 @@ export class MessengerWidget extends BaseWidget {
 					isOwn: msg.sender_type === 'customer',
 					timestamp: msg.created_at,
 					sender: {
-						name: msg.sender_name || (msg.sender_type === 'customer' ? 'You' : 'Support'),
+						name:
+							msg.sender_name ||
+							(msg.sender_type === 'customer' ? 'You' : 'Support'),
 						avatarUrl: msg.sender_avatar || null,
 					},
 				}));

package/src/widgets/messenger/views/ChatView.js

@@ -37,7 +37,10 @@ export class ChatView {
 				data.conversationId === this.state.activeConversationId
 			) {
 				this._hideTypingIndicator();
-			} else if (type === 'messagesUpdate' && data.conversationId === this.state.activeConversationId) {
+			} else if (
+				type === 'messagesUpdate' &&
+				data.conversationId === this.state.activeConversationId
+			) {
 				this._updateContent();
 			}
 		});
@@ -97,14 +100,17 @@ export class ChatView {
 			</div>
 		`;
 
-		this._typingIndicator = this.element.querySelector('.messenger-typing-indicator');
+		this._typingIndicator = this.element.querySelector(
+			'.messenger-typing-indicator'
+		);
 		this._attachEvents();
 		this._scrollToBottom();
 	}
 
 	_renderEmptyState(isNewConversation = false) {
 		const avatarHtml = this._renderTeamAvatars();
-		const responseTime = this.state.responseTime || 'We typically reply within a few minutes';
+		const responseTime =
+			this.state.responseTime || 'We typically reply within a few minutes';
 		const isOnline = this.state.agentsOnline;
 
 		return `
@@ -360,7 +366,9 @@ export class ChatView {
 	_showTypingIndicator(userName) {
 		if (this._typingIndicator) {
 			this._typingIndicator.style.display = 'flex';
-			const textEl = this._typingIndicator.querySelector('.messenger-typing-text');
+			const textEl = this._typingIndicator.querySelector(
+				'.messenger-typing-text'
+			);
 			if (textEl) {
 				textEl.textContent = `${userName || 'Support'} is typing...`;
 			}

package/src/widgets/messenger/views/HomeView.js

@@ -17,7 +17,11 @@ export class HomeView {
 
 		// Subscribe to state changes to re-render when data loads
 		this._unsubscribe = this.state.subscribe((type) => {
-			if (type === 'homeChangelogUpdate' || type === 'conversationsUpdate' || type === 'availabilityUpdate') {
+			if (
+				type === 'homeChangelogUpdate' ||
+				type === 'conversationsUpdate' ||
+				type === 'availabilityUpdate'
+			) {
 				this._updateContent();
 			}
 		});
@@ -94,7 +98,8 @@ export class HomeView {
 
 	_renderAvailabilityStatus() {
 		const isOnline = this.state.agentsOnline;
-		const responseTime = this.state.responseTime || 'We typically reply within a few minutes';
+		const responseTime =
+			this.state.responseTime || 'We typically reply within a few minutes';
 
 		if (isOnline) {
 			return `

package/types/index.d.ts

@@ -159,6 +159,55 @@ declare module '@product7/feedback-sdk' {
 		refresh(): Promise<void>;
 	}
 
+	export interface MessengerWidgetOptions {
+		position?: 'bottom-right' | 'bottom-left';
+		theme?: 'light' | 'dark';
+		teamName?: string;
+		teamAvatars?: string[];
+		welcomeMessage?: string;
+		enableHelp?: boolean;
+		enableChangelog?: boolean;
+		logoUrl?: string;
+		primaryColor?: string;
+		featuredContent?: {
+			title: string;
+			description: string;
+			imageUrl?: string;
+			action?: {
+				type: 'url' | 'view';
+				value: string;
+				label: string;
+			};
+		};
+		onSendMessage?: (conversationId: string, message: any) => void;
+		onArticleClick?: (article: any) => void;
+		onChangelogClick?: (changelog: any) => void;
+	}
+
+	export interface MessengerWidget {
+		id: string;
+		type: 'messenger';
+		mount(container?: string | HTMLElement): this;
+		destroy(): void;
+		open(): void;
+		close(): void;
+		toggle(): void;
+		navigateTo(view: 'home' | 'messages' | 'chat' | 'help' | 'changelog'): void;
+		setConversations(conversations: any[]): void;
+		setHelpArticles(articles: any[]): void;
+		setChangelogItems(items: any[]): void;
+		setHomeChangelogItems(items: any[]): void;
+		setUnreadCount(count: number): void;
+		loadInitialData(): Promise<void>;
+		checkAgentAvailability(): Promise<any>;
+		getState(): {
+			isOpen: boolean;
+			currentView: string;
+			unreadCount: number;
+			conversations: any[];
+		};
+	}
+
 	const FeedbackSDKDefault: FeedbackSDKExport;
 	export default FeedbackSDKDefault;
 }