@product7/feedback-sdk 1.2.4 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@product7/feedback-sdk",
-	"version": "1.2.4",
+	"version": "1.2.6",
 	"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

@@ -9,6 +9,175 @@ const MOCK_CONFIG = {
 	displayMode: 'modal',
 };
 
+// Mock changelogs for development
+const MOCK_CHANGELOGS = [
+	{
+		id: 'changelog_1',
+		title:
+			'Feature prioritization, multiple roadmaps, and feature request analytics.',
+		excerpt:
+			'We are super excited to bring you the long-waited feature prioritization together with many quality updates!',
+		description:
+			'We are super excited to bring you the long-waited feature prioritization together with many quality updates!',
+		cover_image:
+			'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDAwIiBoZWlnaHQ9IjI1MCIgdmlld0JveD0iMCAwIDQwMCAyNTAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjQwMCIgaGVpZ2h0PSIyNTAiIGZpbGw9IiNEQkVBRkUiLz48cmVjdCB4PSIyMCIgeT0iMjAiIHdpZHRoPSIzNjAiIGhlaWdodD0iMjEwIiByeD0iOCIgZmlsbD0id2hpdGUiIHN0cm9rZT0iIzE1NUVFRiIgc3Ryb2tlLXdpZHRoPSIyIi8+PHJlY3QgeD0iMzAiIHk9IjQwIiB3aWR0aD0iODAiIGhlaWdodD0iOCIgcng9IjQiIGZpbGw9IiNFNUU3RUIiLz48cmVjdCB4PSIzMCIgeT0iNjAiIHdpZHRoPSIxNDAiIGhlaWdodD0iNDAiIHJ4PSI0IiBmaWxsPSIjRjNGNEY2Ii8+PHRleHQgeD0iNDAiIHk9Ijg1IiBmb250LWZhbWlseT0ic3lzdGVtLXVpIiBmb250LXNpemU9IjE2IiBmb250LXdlaWdodD0iNjAwIiBmaWxsPSIjMUYyOTM3Ij4yMDA8L3RleHQ+PHRleHQgeD0iNDAiIHk9Ijk1IiBmb250LWZhbWlseT0ic3lzdGVtLXVpIiBmb250LXNpemU9IjgiIGZpbGw9IiM2QjcyODAiPlBvc3RzPC90ZXh0PjxyZWN0IHg9IjE4MCIgeT0iNjAiIHdpZHRoPSI4MCIgaGVpZ2h0PSI0MCIgcng9IjQiIGZpbGw9IiNGM0Y0RjYiLz48cmVjdCB4PSIyNzAiIHk9IjYwIiB3aWR0aD0iODAiIGhlaWdodD0iNDAiIHJ4PSI0IiBmaWxsPSIjRjNGNEY2Ii8+PHBhdGggZD0iTTMwIDEzMEgzNzBNMzAgMTUwSDM3ME0zMCAxNzBIMzcwTTMwIDE5MEgzNzAiIHN0cm9rZT0iI0U1RTdFQiIgc3Ryb2tlLXdpZHRoPSIxIi8+PHBhdGggZD0iTTUwIDE2MEwxMDAgMTQwTDE1MCAxNTBMMjAwIDEzMEwyNTAgMTM1TDMwMCAxMjBMMzUwIDEyNSIgc3Ryb2tlPSIjMTU1RUVGIiBzdHJva2Utd2lkdGg9IjIiIGZpbGw9Im5vbmUiLz48L3N2Zz4=',
+		slug: 'feature-prioritization-roadmaps-analytics',
+		published_at: '2025-03-15T10:00:00Z',
+		labels: [
+			{ name: 'New Feature', color: '#10B981' },
+			{ name: 'Analytics', color: '#6366F1' },
+		],
+		status: 'published',
+	},
+	{
+		id: 'changelog_2',
+		title: 'Dark mode support and UI improvements',
+		excerpt:
+			'You asked for it, we delivered! Dark mode is now available across all pages.',
+		description:
+			'You asked for it, we delivered! Dark mode is now available across all pages.',
+		cover_image:
+			'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDAwIiBoZWlnaHQ9IjI1MCIgdmlld0JveD0iMCAwIDQwMCAyNTAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjQwMCIgaGVpZ2h0PSIyNTAiIGZpbGw9IiMxRjI5MzciLz48cmVjdCB4PSIyMCIgeT0iMjAiIHdpZHRoPSIzNjAiIGhlaWdodD0iMjEwIiByeD0iOCIgZmlsbD0iIzM3NDE1MSIgc3Ryb2tlPSIjNEI1NTYzIiBzdHJva2Utd2lkdGg9IjEiLz48Y2lyY2xlIGN4PSIyMDAiIGN5PSIxMjUiIHI9IjQwIiBmaWxsPSIjRkJCRjI0Ii8+PHBhdGggZD0iTTIyMCAxMjVDMjIwIDEzNiAyMTEgMTQ1IDIwMCAxNDVDMTg5IDE0NSAxODAgMTM2IDE4MCAxMjVDMTgwIDExNCAxODkgMTA1IDIwMCAxMDVDMjExIDEwNSAyMjAgMTE0IDIyMCAxMjVaIiBmaWxsPSIjMUYyOTM3Ii8+PC9zdmc+',
+		slug: 'dark-mode-ui-improvements',
+		published_at: '2025-03-01T10:00:00Z',
+		labels: [{ name: 'Enhancement', color: '#8B5CF6' }],
+		status: 'published',
+	},
+	{
+		id: 'changelog_3',
+		title: 'Performance improvements and bug fixes',
+		excerpt:
+			'This release includes major performance improvements and several bug fixes.',
+		description:
+			'This release includes major performance improvements and several bug fixes.',
+		slug: 'performance-improvements-bug-fixes',
+		published_at: '2025-02-15T10:00:00Z',
+		labels: [
+			{ name: 'Bug Fix', color: '#EF4444' },
+			{ name: 'Performance', color: '#F59E0B' },
+		],
+		status: 'published',
+	},
+];
+
+// Mock conversations for development
+const MOCK_CONVERSATIONS = [
+	{
+		id: 'conv_1',
+		subject: 'Question about pricing',
+		status: 'open',
+		last_message_at: new Date(Date.now() - 49 * 60 * 1000).toISOString(),
+		created_at: new Date(Date.now() - 2 * 24 * 60 * 60 * 1000).toISOString(),
+		unread: 1,
+		assigned_user: {
+			id: 'user_1',
+			name: 'Sarah',
+			avatar: null,
+		},
+	},
+	{
+		id: 'conv_2',
+		subject: 'Feature request',
+		status: 'open',
+		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: {
+			id: 'user_2',
+			name: 'Tom',
+			avatar: null,
+		},
+	},
+];
+
+// Mock messages for development
+const MOCK_MESSAGES = {
+	conv_1: [
+		{
+			id: 'msg_1',
+			content: "Hi there! 👋 I'm Sarah. How can I help you today?",
+			sender_type: 'agent',
+			sender_name: 'Sarah',
+			sender_avatar: null,
+			created_at: new Date(Date.now() - 50 * 60 * 1000).toISOString(),
+		},
+		{
+			id: 'msg_2',
+			content: 'Hi! I have a question about your enterprise pricing.',
+			sender_type: 'customer',
+			created_at: new Date(Date.now() - 49 * 60 * 1000).toISOString(),
+		},
+	],
+	conv_2: [
+		{
+			id: 'msg_3',
+			content: "Hello! I'm Tom from the product team.",
+			sender_type: 'agent',
+			sender_name: 'Tom',
+			sender_avatar: null,
+			created_at: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString(),
+		},
+		{
+			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(),
+		},
+		{
+			id: 'msg_5',
+			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,
+			created_at: new Date(Date.now() - 6 * 24 * 60 * 60 * 1000).toISOString(),
+		},
+	],
+};
+
+// Mock help collections for development
+const MOCK_HELP_COLLECTIONS = [
+	{
+		id: 'collection_1',
+		title: 'Product Overview',
+		description: 'See how your AI-first customer service solution works.',
+		articleCount: 24,
+		icon: 'ph-book-open',
+		url: '#',
+	},
+	{
+		id: 'collection_2',
+		title: 'Getting Started',
+		description: 'Everything you need to know to get started with Product7.',
+		articleCount: 30,
+		icon: 'ph-rocket',
+		url: '#',
+	},
+	{
+		id: 'collection_3',
+		title: 'AI Agent',
+		description: 'Resolving customer questions instantly and accurately—from live chat to email.',
+		articleCount: 82,
+		icon: 'ph-robot',
+		url: '#',
+	},
+	{
+		id: 'collection_4',
+		title: 'Channels',
+		description: 'Enabling the channels you use to communicate with customers, all from the Inbox.',
+		articleCount: 45,
+		icon: 'ph-chat-circle',
+		url: '#',
+	},
+	{
+		id: 'collection_5',
+		title: 'Billing & Payments',
+		description: 'Manage your subscription, invoices, and payment methods.',
+		articleCount: 12,
+		icon: 'ph-credit-card',
+		url: '#',
+	},
+];
+
 // Mock surveys for development
 const MOCK_SURVEYS = [
 	{
@@ -430,6 +599,480 @@ export class APIService {
 		}
 	}
 
+	// ==========================================
+	// MESSENGER / CHAT ENDPOINTS
+	// ==========================================
+
+	/**
+	 * Get messenger settings
+	 * @returns {Promise<Object>} Messenger settings
+	 */
+	async getMessengerSettings() {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			return {
+				status: true,
+				data: {
+					enabled: true,
+					greeting_message: 'Hi there! How can we help you today?',
+					team_name: 'Support Team',
+					response_time: 'Usually replies within a few minutes',
+				},
+			};
+		}
+
+		return this._makeRequest('/widget/messenger/settings', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Check if agents are online
+	 * @returns {Promise<Object>} Agent availability status
+	 */
+	async checkAgentsOnline() {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			return {
+				status: true,
+				data: {
+					agents_online: true,
+					online_count: 2,
+					response_time: 'Usually replies within a few minutes',
+				},
+			};
+		}
+
+		return this._makeRequest('/widget/messenger/agents/online', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Get all conversations for the current contact
+	 * @param {Object} options - Query options
+	 * @param {number} options.page - Page number
+	 * @param {number} options.limit - Items per page
+	 * @returns {Promise<Object>} Conversations list
+	 */
+	async getConversations(options = {}) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 300));
+			return {
+				status: true,
+				data: MOCK_CONVERSATIONS,
+				meta: { total: MOCK_CONVERSATIONS.length, page: 1, limit: 20 },
+			};
+		}
+
+		const params = new URLSearchParams();
+		if (options.page) params.append('page', options.page);
+		if (options.limit) params.append('limit', options.limit);
+
+		const endpoint = `/widget/messenger/conversations${params.toString() ? '?' + params.toString() : ''}`;
+		return this._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Get a single conversation with messages
+	 * @param {string} conversationId - Conversation ID
+	 * @returns {Promise<Object>} Conversation with messages
+	 */
+	async getConversation(conversationId) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 200));
+			const conv = MOCK_CONVERSATIONS.find((c) => c.id === conversationId);
+			return {
+				status: true,
+				data: {
+					...conv,
+					messages: MOCK_MESSAGES[conversationId] || [],
+				},
+			};
+		}
+
+		return this._makeRequest(`/widget/messenger/conversations/${conversationId}`, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Get messages for a conversation
+	 * @param {string} conversationId - Conversation ID
+	 * @param {Object} options - Query options
+	 * @returns {Promise<Object>} Messages list
+	 */
+	async getMessages(conversationId, options = {}) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 200));
+			return {
+				status: true,
+				data: MOCK_MESSAGES[conversationId] || [],
+			};
+		}
+
+		const params = new URLSearchParams();
+		if (options.page) params.append('page', options.page);
+		if (options.limit) params.append('limit', options.limit);
+
+		const endpoint = `/widget/messenger/conversations/${conversationId}/messages${params.toString() ? '?' + params.toString() : ''}`;
+		return this._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Start a new conversation
+	 * @param {Object} data - Conversation data
+	 * @param {string} data.message - Initial message content
+	 * @param {string} data.subject - Optional subject
+	 * @returns {Promise<Object>} Created conversation
+	 */
+	async startConversation(data) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 300));
+			const newConv = {
+				id: 'conv_' + Date.now(),
+				subject: data.subject || 'New conversation',
+				status: 'open',
+				last_message_at: new Date().toISOString(),
+				created_at: new Date().toISOString(),
+				messages: [
+					{
+						id: 'msg_' + Date.now(),
+						content: data.message,
+						sender_type: 'customer',
+						created_at: new Date().toISOString(),
+					},
+				],
+			};
+			MOCK_CONVERSATIONS.unshift(newConv);
+			MOCK_MESSAGES[newConv.id] = newConv.messages;
+			return { status: true, data: newConv };
+		}
+
+		return this._makeRequest('/widget/messenger/conversations', {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+				Authorization: `Bearer ${this.sessionToken}`,
+			},
+			body: JSON.stringify({
+				message: data.message,
+				subject: data.subject || '',
+			}),
+		});
+	}
+
+	/**
+	 * Send a message in a conversation
+	 * @param {string} conversationId - Conversation ID
+	 * @param {Object} data - Message data
+	 * @param {string} data.content - Message content
+	 * @returns {Promise<Object>} Sent message
+	 */
+	async sendMessage(conversationId, data) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 200));
+			const newMessage = {
+				id: 'msg_' + Date.now(),
+				content: data.content,
+				sender_type: 'customer',
+				created_at: new Date().toISOString(),
+			};
+			if (!MOCK_MESSAGES[conversationId]) {
+				MOCK_MESSAGES[conversationId] = [];
+			}
+			MOCK_MESSAGES[conversationId].push(newMessage);
+			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 }),
+		});
+	}
+
+	/**
+	 * Send typing indicator
+	 * @param {string} conversationId - Conversation ID
+	 * @param {boolean} isTyping - Whether user is typing
+	 * @returns {Promise<Object>} Response
+	 */
+	async sendTypingIndicator(conversationId, isTyping) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			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 }),
+		});
+	}
+
+	/**
+	 * Mark conversation as read
+	 * @param {string} conversationId - Conversation ID
+	 * @returns {Promise<Object>} Response
+	 */
+	async markConversationAsRead(conversationId) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			return { status: true };
+		}
+
+		return this._makeRequest(`/widget/messenger/conversations/${conversationId}/read`, {
+			method: 'POST',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Get unread count
+	 * @returns {Promise<Object>} Unread count data
+	 */
+	async getUnreadCount() {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			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 },
+			};
+		}
+
+		return this._makeRequest('/widget/messenger/unread', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Submit conversation rating
+	 * @param {string} conversationId - Conversation ID
+	 * @param {Object} data - Rating data
+	 * @param {number} data.rating - Rating (1-5 or thumbs up/down)
+	 * @param {string} data.comment - Optional comment
+	 * @returns {Promise<Object>} Response
+	 */
+	async submitRating(conversationId, data) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			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 || '',
+			}),
+		});
+	}
+
+	/**
+	 * Identify contact (for logged-in users)
+	 * @param {Object} data - Contact data
+	 * @param {string} data.email - Email address
+	 * @param {string} data.name - Name
+	 * @returns {Promise<Object>} Response
+	 */
+	async identifyContact(data) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			return { status: true, message: 'Contact identified' };
+		}
+
+		return this._makeRequest('/widget/messenger/identify', {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+				Authorization: `Bearer ${this.sessionToken}`,
+			},
+			body: JSON.stringify(data),
+		});
+	}
+
+	// ==========================================
+	// HELP ARTICLES ENDPOINTS
+	// ==========================================
+
+	/**
+	 * Get help collections
+	 * @param {Object} options - Query options
+	 * @returns {Promise<Object>} Collections list
+	 */
+	async getHelpCollections(options = {}) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 200));
+			return { status: true, data: MOCK_HELP_COLLECTIONS };
+		}
+
+		const params = new URLSearchParams();
+		if (options.limit) params.append('limit', options.limit);
+
+		const endpoint = `/widget/help/collections${params.toString() ? '?' + params.toString() : ''}`;
+		return this._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	/**
+	 * Search help articles
+	 * @param {string} query - Search query
+	 * @param {Object} options - Query options
+	 * @returns {Promise<Object>} Search results
+	 */
+	async searchHelpArticles(query, options = {}) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 200));
+			const filtered = MOCK_HELP_COLLECTIONS.filter(
+				(c) =>
+					c.title.toLowerCase().includes(query.toLowerCase()) ||
+					c.description.toLowerCase().includes(query.toLowerCase())
+			);
+			return { status: true, data: filtered };
+		}
+
+		const params = new URLSearchParams({ q: query });
+		if (options.limit) params.append('limit', options.limit);
+
+		return this._makeRequest(`/widget/help/search?${params.toString()}`, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.sessionToken}` },
+		});
+	}
+
+	// ==========================================
+	// CHANGELOG ENDPOINTS
+	// ==========================================
+
+	/**
+	 * Get published changelogs
+	 * @param {Object} options - Optional query parameters
+	 * @param {number} options.limit - Number of changelogs to fetch
+	 * @param {number} options.offset - Offset for pagination
+	 * @returns {Promise<Object>} Changelogs response
+	 */
+	async getChangelogs(options = {}) {
+		if (!this.isSessionValid()) {
+			await this.init();
+		}
+
+		if (!this.sessionToken) {
+			throw new APIError(401, 'No valid session token available');
+		}
+
+		// Mock mode - return mock changelogs
+		if (this.mock) {
+			await new Promise((resolve) => setTimeout(resolve, 300));
+			return {
+				success: true,
+				data: MOCK_CHANGELOGS,
+			};
+		}
+
+		try {
+			const queryParams = new URLSearchParams();
+			if (options.limit) queryParams.append('limit', options.limit);
+			if (options.offset) queryParams.append('offset', options.offset);
+
+			const endpoint = `/widget/changelogs${queryParams.toString() ? '?' + queryParams.toString() : ''}`;
+
+			const response = await this._makeRequest(endpoint, {
+				method: 'GET',
+				headers: {
+					Authorization: `Bearer ${this.sessionToken}`,
+				},
+			});
+
+			return response;
+		} catch (error) {
+			if (error.status === 401) {
+				this.sessionToken = null;
+				this.sessionExpiry = null;
+				await this.init();
+				return this.getChangelogs(options);
+			}
+
+			throw new APIError(
+				error.status || 500,
+				`Failed to get changelogs: ${error.message}`,
+				error.response
+			);
+		}
+	}
+
 	isSessionValid() {
 		return (
 			this.sessionToken && this.sessionExpiry && new Date() < this.sessionExpiry