@product7/feedback-sdk 1.2.5 → 1.2.6

package/package.json

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

@@ -60,6 +60,124 @@ const MOCK_CHANGELOGS = [
 	},
 ];
 
+// 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 = [
 	{
@@ -481,6 +599,424 @@ 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

package/src/core/FeedbackSDK.js

@@ -345,6 +345,54 @@ export class FeedbackSDK {
 		this.eventBus.emit('sdk:destroyed');
 	}
 
+	/**
+	 * Check if feedback was recently submitted for this workspace
+	 * Uses backend tracking (preferred) with localStorage as fallback
+	 * @param {number} cooldownDays - Days to consider as "recently" (default: 30)
+	 * @returns {boolean} true if feedback was submitted within the cooldown period
+	 */
+	hasFeedbackBeenSubmitted(cooldownDays = 30) {
+		const cooldownMs = cooldownDays * 24 * 60 * 60 * 1000;
+		const now = Date.now();
+
+		// 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) {
+					return true;
+				}
+			} catch (e) {
+				// Invalid date format, continue to localStorage check
+			}
+		}
+
+		// Fallback to localStorage
+		try {
+			const storageKey = `feedback_submitted_${this.config.workspace}`;
+			const stored = localStorage.getItem(storageKey);
+			if (!stored) return false;
+
+			const data = JSON.parse(stored);
+			return (now - data.submittedAt) < cooldownMs;
+		} catch (e) {
+			return false;
+		}
+	}
+
+	/**
+	 * Clear the feedback submission tracking (allow showing widgets again)
+	 */
+	clearFeedbackSubmissionTracking() {
+		try {
+			const storageKey = `feedback_submitted_${this.config.workspace}`;
+			localStorage.removeItem(storageKey);
+			this.eventBus.emit('feedback:trackingCleared');
+		} catch (e) {
+			console.warn('Failed to clear feedback tracking:', e);
+		}
+	}
+
 	_detectEnvironment() {
 		if (typeof window === 'undefined') {
 			return 'production';