@product7/feedback-sdk 1.2.8 → 1.3.0

package/package.json

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

package/src/api/mock-data/index.js

@@ -0,0 +1,202 @@
+export 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',
+	},
+];
+
+export 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,
+		},
+	},
+];
+
+export 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(),
+		},
+	],
+};
+
+export 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: '#',
+	},
+];
+
+export const MOCK_SURVEYS = [
+	{
+		id: 'mock_nps_survey',
+		type: 'nps',
+		title: 'How likely are you to recommend us?',
+		description: 'Your feedback helps us improve',
+		low_label: 'Not likely',
+		high_label: 'Very likely',
+		trigger: 'manual',
+		status: 'active',
+	},
+	{
+		id: 'mock_csat_survey',
+		type: 'csat',
+		title: 'How satisfied are you?',
+		description: 'Rate your experience with our product',
+		trigger: 'manual',
+		status: 'active',
+	},
+	{
+		id: 'mock_ces_survey',
+		type: 'ces',
+		title: 'How easy was it?',
+		description: 'Rate the ease of completing your task',
+		low_label: 'Very difficult',
+		high_label: 'Very easy',
+		trigger: 'manual',
+		status: 'active',
+	},
+];

package/src/api/services/ChangelogService.js

@@ -0,0 +1,28 @@
+import { MOCK_CHANGELOGS } from '../mock-data';
+import { delay } from '../utils/helpers.js';
+
+export class ChangelogService {
+	constructor(baseAPI) {
+		this.api = baseAPI;
+	}
+
+	async getChangelogs(options = {}) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(300);
+			return { success: true, data: MOCK_CHANGELOGS };
+		}
+
+		return this.api._handleAuthRetry(async () => {
+			const endpoint = this.api._getEndpointWithParams(
+				'/widget/changelogs',
+				options
+			);
+			return await this.api._makeRequest(endpoint, {
+				method: 'GET',
+				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+			});
+		});
+	}
+}

package/src/api/services/FeedbackService.js

@@ -0,0 +1,44 @@
+import { delay } from '../utils/helpers.js';
+
+export class FeedbackService {
+	constructor(baseAPI) {
+		this.api = baseAPI;
+	}
+
+	async submitFeedback(feedbackData) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(500);
+			return {
+				success: true,
+				data: {
+					id: 'mock_post_' + Date.now(),
+					title: feedbackData.title,
+					content: feedbackData.content,
+				},
+				message: 'Feedback submitted successfully!',
+			};
+		}
+
+		const payload = {
+			board:
+				feedbackData.board_id || feedbackData.board || feedbackData.boardId,
+			title: feedbackData.title,
+			content: feedbackData.content,
+			attachments: feedbackData.attachments || [],
+		};
+
+		return this.api._handleAuthRetry(async () => {
+			const response = await this.api._makeRequest('/widget/feedback', {
+				method: 'POST',
+				body: JSON.stringify(payload),
+				headers: {
+					'Content-Type': 'application/json',
+					Authorization: `Bearer ${this.api.sessionToken}`,
+				},
+			});
+			return response;
+		});
+	}
+}

package/src/api/services/HelpService.js

@@ -0,0 +1,50 @@
+import { MOCK_HELP_COLLECTIONS } from '../mock-data';
+import { delay } from '../utils/helpers.js';
+
+export class HelpService {
+	constructor(baseAPI) {
+		this.api = baseAPI;
+	}
+
+	async getHelpCollections(options = {}) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(200);
+			return { status: true, data: MOCK_HELP_COLLECTIONS };
+		}
+
+		const endpoint = this.api._getEndpointWithParams(
+			'/widget/help/collections',
+			options
+		);
+		return this.api._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+
+	async searchHelpArticles(query, options = {}) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(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 = { q: query, ...options };
+		const endpoint = this.api._getEndpointWithParams(
+			'/widget/help/search',
+			params
+		);
+		return this.api._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+}

package/src/api/services/MessengerService.js

@@ -0,0 +1,197 @@
+import { MOCK_CONVERSATIONS, MOCK_MESSAGES } from '../mock-data';
+import { delay } from '../utils/helpers.js';
+
+export class MessengerService {
+	constructor(baseAPI) {
+		this.api = baseAPI;
+	}
+
+	async getMessengerSettings() {
+		await this.api._ensureSession();
+
+		if (this.api.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.api._makeRequest('/widget/messenger/settings', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+
+	async checkAgentsOnline() {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			return {
+				status: true,
+				data: {
+					agents_online: true,
+					online_count: 2,
+					response_time: 'Usually replies within a few minutes',
+				},
+			};
+		}
+
+		return this.api._makeRequest('/widget/messenger/agents/online', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+
+	async getConversations(options = {}) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(300);
+			return {
+				status: true,
+				data: MOCK_CONVERSATIONS,
+				meta: { total: MOCK_CONVERSATIONS.length, page: 1, limit: 20 },
+			};
+		}
+
+		const endpoint = this.api._getEndpointWithParams(
+			'/widget/messenger/conversations',
+			options
+		);
+		return this.api._makeRequest(endpoint, {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+
+	async getConversation(conversationId) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(200);
+			const conv = MOCK_CONVERSATIONS.find((c) => c.id === conversationId);
+			return {
+				status: true,
+				data: { ...conv, messages: MOCK_MESSAGES[conversationId] || [] },
+			};
+		}
+
+		return this.api._makeRequest(
+			`/widget/messenger/conversations/${conversationId}`,
+			{
+				method: 'GET',
+				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+			}
+		);
+	}
+
+	async startConversation(data) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(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.api._makeRequest('/widget/messenger/conversations', {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+				Authorization: `Bearer ${this.api.sessionToken}`,
+			},
+			body: JSON.stringify({
+				message: data.message,
+				subject: data.subject || '',
+			}),
+		});
+	}
+
+	async sendMessage(conversationId, data) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(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.api._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/messages`,
+			{
+				method: 'POST',
+				headers: {
+					'Content-Type': 'application/json',
+					Authorization: `Bearer ${this.api.sessionToken}`,
+				},
+				body: JSON.stringify({ content: data.content }),
+			}
+		);
+	}
+
+	async getUnreadCount() {
+		await this.api._ensureSession();
+
+		if (this.api.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.api._makeRequest('/widget/messenger/unread', {
+			method: 'GET',
+			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+		});
+	}
+
+	async markConversationAsRead(conversationId) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			return { status: true };
+		}
+
+		return this.api._makeRequest(
+			`/widget/messenger/conversations/${conversationId}/read`,
+			{
+				method: 'POST',
+				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+			}
+		);
+	}
+}

package/src/api/services/SurveyService.js

@@ -0,0 +1,99 @@
+import { APIError } from '../../utils/errors.js';
+import { MOCK_SURVEYS } from '../mock-data';
+import { delay, getDeviceInfo } from '../utils/helpers.js';
+
+export class SurveyService {
+	constructor(baseAPI) {
+		this.api = baseAPI;
+	}
+
+	async getActiveSurveys(context = {}) {
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(200);
+			return { success: true, data: MOCK_SURVEYS };
+		}
+
+		const params = {
+			url:
+				context.url ||
+				(typeof window !== 'undefined' ? window.location.href : ''),
+			...getDeviceInfo(),
+			...(context.userProperties && {
+				user_properties: context.userProperties,
+			}),
+		};
+
+		return this.api._handleAuthRetry(async () => {
+			const endpoint = this.api._getEndpointWithParams(
+				'/widget/surveys/active',
+				params
+			);
+			return await this.api._makeRequest(endpoint, {
+				method: 'GET',
+				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+			});
+		});
+	}
+
+	async submitSurveyResponse(surveyId, responseData) {
+		if (!surveyId) throw new APIError(400, 'Survey ID is required');
+
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(300);
+			return {
+				success: true,
+				data: {
+					id: 'mock_response_' + Date.now(),
+					survey_id: surveyId,
+					...responseData,
+				},
+				message: 'Survey response submitted successfully!',
+			};
+		}
+
+		const payload = {
+			rating: responseData.rating,
+			feedback: responseData.feedback || '',
+			answers: responseData.answers || {},
+		};
+
+		return this.api._handleAuthRetry(async () => {
+			return await this.api._makeRequest(
+				`/widget/surveys/${surveyId}/responses`,
+				{
+					method: 'POST',
+					body: JSON.stringify(payload),
+					headers: {
+						'Content-Type': 'application/json',
+						Authorization: `Bearer ${this.api.sessionToken}`,
+					},
+				}
+			);
+		});
+	}
+
+	async dismissSurvey(surveyId) {
+		if (!surveyId) throw new APIError(400, 'Survey ID is required');
+
+		await this.api._ensureSession();
+
+		if (this.api.mock) {
+			await delay(100);
+			return { success: true, message: 'Survey dismissed successfully' };
+		}
+
+		return this.api._handleAuthRetry(async () => {
+			return await this.api._makeRequest(
+				`/widget/surveys/${surveyId}/dismiss`,
+				{
+					method: 'POST',
+					headers: { Authorization: `Bearer ${this.api.sessionToken}` },
+				}
+			);
+		});
+	}
+}

package/src/api/utils/helpers.js

@@ -0,0 +1,30 @@
+export const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+export function getDeviceInfo() {
+	if (typeof navigator === 'undefined') {
+		return { device: null, browser: null, os: null };
+	}
+
+	const ua = navigator.userAgent;
+
+	let device = 'desktop';
+	if (/Mobi|Android/i.test(ua)) {
+		device = /Tablet|iPad/i.test(ua) ? 'tablet' : 'mobile';
+	}
+
+	let browser = 'unknown';
+	if (ua.includes('Firefox')) browser = 'firefox';
+	else if (ua.includes('Edg')) browser = 'edge';
+	else if (ua.includes('Chrome')) browser = 'chrome';
+	else if (ua.includes('Safari')) browser = 'safari';
+	else if (ua.includes('Opera') || ua.includes('OPR')) browser = 'opera';
+
+	let os = 'unknown';
+	if (ua.includes('Windows')) os = 'windows';
+	else if (ua.includes('Mac')) os = 'macos';
+	else if (ua.includes('Linux')) os = 'linux';
+	else if (ua.includes('Android')) os = 'android';
+	else if (ua.includes('iPhone') || ua.includes('iPad')) os = 'ios';
+
+	return { device, browser, os };
+}