@product7/product7-js 0.5.2 → 0.5.4

package/package.json

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

package/src/api/APIService.js

@@ -0,0 +1 @@
+

package/src/api/services/{MessengerService.js → WebChatService.js}

@@ -1,12 +1,12 @@
-import { MOCK_CONVERSATIONS, MOCK_MESSAGES } from '../mock-data/index.js';
+import { MOCK_CONVERSATIONS, MOCK_MESSAGES } from '../mock-data/index.js';
 import { delay } from '../utils/helpers.js';
 
-export class MessengerService {
+export class WebChatService {
 	constructor(baseAPI) {
 		this.api = baseAPI;
 	}
 
-	async getMessengerSettings() {
+	async getWebChatSettings() {
 		await this.api._ensureSession();
 
 		if (this.api.mock) {
@@ -21,7 +21,7 @@ export class MessengerService {
 			};
 		}
 
-		return this.api._makeRequest('/widget/messenger/settings', {
+		return this.api._makeRequest('/widget/web-chat/settings', {
 			method: 'GET',
 			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
 		});
@@ -45,7 +45,7 @@ export class MessengerService {
 			};
 		}
 
-		return this.api._makeRequest('/widget/messenger/agents/online', {
+		return this.api._makeRequest('/widget/web-chat/agents/online', {
 			method: 'GET',
 			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
 		});
@@ -64,7 +64,7 @@ export class MessengerService {
 		}
 
 		const endpoint = this.api._getEndpointWithParams(
-			'/widget/messenger/conversations',
+			'/widget/web-chat/conversations',
 			options
 		);
 		return this.api._makeRequest(endpoint, {
@@ -86,7 +86,7 @@ export class MessengerService {
 		}
 
 		return this.api._makeRequest(
-			`/widget/messenger/conversations/${conversationId}`,
+			`/widget/web-chat/conversations/${conversationId}`,
 			{
 				method: 'GET',
 				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
@@ -120,7 +120,7 @@ export class MessengerService {
 			return { status: true, data: newConv };
 		}
 
-		return this.api._makeRequest('/widget/messenger/conversations', {
+		return this.api._makeRequest('/widget/web-chat/conversations', {
 			method: 'POST',
 			headers: {
 				'Content-Type': 'application/json',
@@ -154,7 +154,7 @@ export class MessengerService {
 		}
 
 		return this.api._makeRequest(
-			`/widget/messenger/conversations/${conversationId}/messages`,
+			`/widget/web-chat/conversations/${conversationId}/messages`,
 			{
 				method: 'POST',
 				headers: {
@@ -183,7 +183,7 @@ export class MessengerService {
 			};
 		}
 
-		return this.api._makeRequest('/widget/messenger/unread', {
+		return this.api._makeRequest('/widget/web-chat/unread', {
 			method: 'GET',
 			headers: { Authorization: `Bearer ${this.api.sessionToken}` },
 		});
@@ -197,7 +197,7 @@ export class MessengerService {
 		}
 
 		return this.api._makeRequest(
-			`/widget/messenger/conversations/${conversationId}/read`,
+			`/widget/web-chat/conversations/${conversationId}/read`,
 			{
 				method: 'POST',
 				headers: { Authorization: `Bearer ${this.api.sessionToken}` },
@@ -219,7 +219,7 @@ export class MessengerService {
 
 		const params = { ...options };
 		const endpoint = this.api._getEndpointWithParams(
-			`/widget/messenger/conversations/${conversationId}/messages`,
+			`/widget/web-chat/conversations/${conversationId}/messages`,
 			params
 		);
 		return this.api._makeRequest(endpoint, {
@@ -236,7 +236,7 @@ export class MessengerService {
 			return { status: true, url: `https://mock-cdn.example.com/${filename}` };
 		}
 
-		return this.api._makeRequest('/widget/messenger/upload', {
+		return this.api._makeRequest('/widget/web-chat/upload', {
 			method: 'POST',
 			headers: {
 				'Content-Type': 'application/json',
@@ -258,7 +258,7 @@ export class MessengerService {
 		}
 
 		return this.api._makeRequest(
-			`/widget/messenger/conversations/${conversationId}/rating`,
+			`/widget/web-chat/conversations/${conversationId}/rating`,
 			{
 				method: 'POST',
 				headers: {
@@ -278,7 +278,7 @@ export class MessengerService {
 		}
 
 		return this.api._makeRequest(
-			`/widget/messenger/conversations/${conversationId}/typing`,
+			`/widget/web-chat/conversations/${conversationId}/typing`,
 			{
 				method: 'POST',
 				headers: {

package/src/core/APIService.js

@@ -1,8 +1,8 @@
-import { ChangelogService } from '../api/services/ChangelogService.js';
+import { ChangelogService } from '../api/services/ChangelogService.js';
 import { FeedbackService } from '../api/services/FeedbackService.js';
 import { HelpService } from '../api/services/HelpService.js';
-import { MessengerService } from '../api/services/MessengerService.js';
 import { SurveyService } from '../api/services/SurveyService.js';
+import { WebChatService } from '../api/services/WebChatService.js';
 import { BaseAPIService } from './BaseAPIService.js';
 
 export class APIService extends BaseAPIService {
@@ -11,7 +11,7 @@ export class APIService extends BaseAPIService {
 
 		this.feedback = new FeedbackService(this);
 		this.survey = new SurveyService(this);
-		this.messenger = new MessengerService(this);
+		this.webChat = new WebChatService(this);
 		this.help = new HelpService(this);
 		this.changelog = new ChangelogService(this);
 	}
@@ -32,52 +32,52 @@ export class APIService extends BaseAPIService {
 		return this.survey.dismissSurvey(surveyId);
 	}
 
-	async getMessengerSettings() {
-		return this.messenger.getMessengerSettings();
+	async getWebChatSettings() {
+		return this.webChat.getWebChatSettings();
 	}
 
 	async checkAgentsOnline() {
-		return this.messenger.checkAgentsOnline();
+		return this.webChat.checkAgentsOnline();
 	}
 
 	async getConversations(options) {
-		return this.messenger.getConversations(options);
+		return this.webChat.getConversations(options);
 	}
 
 	async getConversation(conversationId) {
-		return this.messenger.getConversation(conversationId);
+		return this.webChat.getConversation(conversationId);
 	}
 
 	async getMessages(conversationId, options) {
-		return this.messenger.getMessages(conversationId, options);
+		return this.webChat.getMessages(conversationId, options);
 	}
 
 	async startConversation(data) {
-		return this.messenger.startConversation(data);
+		return this.webChat.startConversation(data);
 	}
 
 	async sendMessage(conversationId, data) {
-		return this.messenger.sendMessage(conversationId, data);
+		return this.webChat.sendMessage(conversationId, data);
 	}
 
 	async uploadFile(base64Data, filename) {
-		return this.messenger.uploadFile(base64Data, filename);
+		return this.webChat.uploadFile(base64Data, filename);
 	}
 
 	async sendTypingIndicator(conversationId, isTyping) {
-		return this.messenger.sendTypingIndicator(conversationId, isTyping);
+		return this.webChat.sendTypingIndicator(conversationId, isTyping);
 	}
 
 	async markConversationAsRead(conversationId) {
-		return this.messenger.markConversationAsRead(conversationId);
+		return this.webChat.markConversationAsRead(conversationId);
 	}
 
 	async getUnreadCount() {
-		return this.messenger.getUnreadCount();
+		return this.webChat.getUnreadCount();
 	}
 
 	async submitRating(conversationId, data) {
-		return this.messenger.submitRating(conversationId, data);
+		return this.webChat.submitRating(conversationId, data);
 	}
 
 	async identify(metadata) {

package/src/core/Product7.js

@@ -1,4 +1,4 @@
-import { CSS_STYLES } from '../styles/styles.js';
+import { CSS_STYLES } from '../styles/styles.js';
 import { ConfigError, SDKError } from '../utils/errors.js';
 import { deepMerge, generateId } from '../utils/helpers.js';
 import { WidgetFactory } from '../widgets/WidgetFactory.js';
@@ -130,8 +130,8 @@ export class Product7 {
 		return this.createWidget('feedback', options);
 	}
 
-	createMessengerWidget(options = {}) {
-		return this.createWidget('messenger', options);
+	createWebChatWidget(options = {}) {
+		return this.createWidget('webChat', options);
 	}
 
 	createChangelogWidget(options = {}) {
@@ -923,7 +923,7 @@ export class Product7 {
 	_bindMethods() {
 		this.createWidget = this.createWidget.bind(this);
 		this.createFeedbackWidget = this.createFeedbackWidget.bind(this);
-		this.createMessengerWidget = this.createMessengerWidget.bind(this);
+		this.createWebChatWidget = this.createWebChatWidget.bind(this);
 		this.createChangelogWidget = this.createChangelogWidget.bind(this);
 		this.createSurveyWidget = this.createSurveyWidget.bind(this);
 		this.destroyWidget = this.destroyWidget.bind(this);

package/src/core/WebSocketService.js

@@ -1,5 +1,5 @@
-/**
- * WebSocketService - Real-time communication for messenger widget
+/**
+ * WebSocketService - Real-time communication for web chat widget
  */
 
 export class WebSocketService {
@@ -51,7 +51,7 @@ export class WebSocketService {
 		const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
 		let wsURL = this.baseURL.replace(/^https?:/, wsProtocol);
 		wsURL = wsURL.replace('/api/v1', '');
-		wsURL = `${wsURL}/api/v1/widget/messenger/ws?token=${encodeURIComponent(this.sessionToken)}`;
+		wsURL = `${wsURL}/api/v1/widget/web-chat/ws?token=${encodeURIComponent(this.sessionToken)}`;
 
 		try {
 			this.ws = new WebSocket(wsURL);

package/src/docs/api.md

@@ -60,9 +60,9 @@ const widget = sdk.createFeedbackWidget({
 });
 ```
 
-#### `createMessengerWidget(options?): MessengerWidget`
+#### `createWebChatWidget(options?): WebChatWidget`
 
-Creates the messenger widget.
+Creates the web chat widget.
 
 #### `createChangelogWidget(options?): ChangelogWidget`
 
@@ -78,7 +78,7 @@ Low-level factory for advanced usage. Supported types include:
 
 - `'feedback'`
 - `'button'` (legacy alias for feedback)
-- `'messenger'`
+- `'webChat'`
 - `'survey'`
 - `'changelog'`
 - `'inline'`
@@ -186,9 +186,9 @@ Created by `sdk.createFeedbackWidget()` or `sdk.createWidget('feedback', ...)`.
 
 ---
 
-## MessengerWidget
+## WebChatWidget
 
-Created by `sdk.createMessengerWidget()`.
+Created by `sdk.createWebChatWidget()`.
 
 ### Methods
 
@@ -299,11 +299,11 @@ Created by `sdk.createChangelogWidget()`.
 - `feedback:submitted`
 - `feedback:error`
 
-### Messenger Events
+### Web Chat Events
 
-- `messenger:opened`
-- `messenger:closed`
-- `messenger:messageSent`
+- `webChat:opened`
+- `webChat:closed`
+- `webChat:messageSent`
 
 ### Survey Events
 

package/src/docs/example.md

@@ -203,42 +203,42 @@ if (surveys.length > 0) {
 
 ---
 
-## Messenger Widget
+## Web Chat Widget
 
-### Basic Messenger
+### Basic Web Chat
 
 ```javascript
-const messenger = sdk.createMessengerWidget({
+const webChat = sdk.createWebChatWidget({
 	position: 'bottom-right',
 	teamName: 'Support Team',
 	enableHelp: true,
 	enableChangelog: true,
 });
 
-messenger.mount();
+webChat.mount();
 ```
 
-### Headless Messenger
+### Headless Web Chat
 
 ```javascript
-const messenger = sdk.createMessengerWidget({
+const webChat = sdk.createWebChatWidget({
 	headless: true,
 	enableHelp: true,
 });
 
-messenger.mount();
+webChat.mount();
 
 document
 	.querySelector('#support-link')
-	?.addEventListener('click', () => messenger.open());
+	?.addEventListener('click', () => webChat.open());
 ```
 
-### Programmatic Messenger Navigation
+### Programmatic Web Chat Navigation
 
 ```javascript
-messenger.open();
-messenger.navigateTo('help');
-messenger.close();
+webChat.open();
+webChat.navigateTo('help');
+webChat.close();
 ```
 
 ---

package/src/docs/framework-integrations.md

@@ -542,7 +542,7 @@ Astro renders on the server by default, so initialize Product7 from a client-loa
 
 ## Adding More Widgets
 
-Use the same SDK instance for feedback, survey, messenger, and changelog.
+Use the same SDK instance for feedback, survey, web chat, and changelog.
 
 ```ts
 const feedback = sdk.createFeedbackWidget({
@@ -560,13 +560,13 @@ const survey = sdk.createSurveyWidget({
 survey.mount();
 survey.open();
 
-const messenger = sdk.createMessengerWidget({
+const webChat = sdk.createWebChatWidget({
 	position: 'bottom-right',
 	teamName: 'Support Team',
 	enableHelp: true,
 	enableChangelog: true,
 });
-messenger.mount();
+webChat.mount();
 
 const changelog = sdk.createChangelogWidget({
 	position: 'bottom-left',
@@ -588,5 +588,5 @@ changelog.mount();
   Move SDK code to client-only lifecycle hooks or client-only components.
 - Duplicate widget instances
   Cache widget references and avoid remounting in repeated renders.
-- Messenger shows the launcher when you want only programmatic control
-  Use `headless: true` when creating the messenger widget.
+- Web chat shows the launcher when you want only programmatic control
+  Use `headless: true` when creating the web chat widget.

package/src/index.js

@@ -1,4 +1,4 @@
-import { APIService } from './core/APIService.js';
+import { APIService } from './core/APIService.js';
 import { EventBus } from './core/EventBus.js';
 import { Product7 as Product7SDK } from './core/Product7.js';
 import {
@@ -13,9 +13,9 @@ import { BaseWidget } from './widgets/BaseWidget.js';
 import { ButtonWidget } from './widgets/ButtonWidget.js';
 import { ChangelogWidget } from './widgets/ChangelogWidget.js';
 import { InlineWidget } from './widgets/InlineWidget.js';
-import { MessengerWidget } from './widgets/MessengerWidget.js';
 import { SurveyWidget } from './widgets/SurveyWidget.js';
 import { TabWidget } from './widgets/TabWidget.js';
+import { WebChatWidget } from './widgets/WebChatWidget.js';
 import { WidgetFactory } from './widgets/WidgetFactory.js';
 
 // --- Identify: transform flat user data into internal format ---
@@ -143,7 +143,7 @@ const Product7 = {
 	_organization: null,
 	_q: [],
 	_feedbackWidget: null,
-	_messengerWidget: null,
+	_WebChatWidget: null,
 	_surveyWidget: null,
 
 	version: '1.0.0',
@@ -330,13 +330,13 @@ const Product7 = {
 	},
 
 	// ==================
-	// Messenger
+	// Web Chat
 	// ==================
 
-	async messenger(options = {}, callback) {
+	async webChat(options = {}, callback) {
 		const sdk = await ensureSDK(options);
 		if (!sdk) {
-			Product7._q.push(['messenger', options, callback]);
+			Product7._q.push(['webChat', options, callback]);
 			return null;
 		}
 
@@ -372,63 +372,62 @@ const Product7 = {
 			widgetOptions.position = options.placement;
 		}
 
-		// Messenger is always explicitly shown — never suppress based on feedback submission history
+		// Web Chat is always explicitly shown — never suppress based on feedback submission history
 		widgetOptions.suppressAfterSubmission = false;
 		widgetOptions.enabled = true;
 
 		try {
-			const widget = sdk.createMessengerWidget(widgetOptions);
+			const widget = sdk.createWebChatWidget(widgetOptions);
 			widget.mount();
 			widget.show();
 
-			Product7._messengerWidget = widget;
+			Product7._WebChatWidget = widget;
 
 			if (typeof callback === 'function') {
 				callback({ action: 'widgetReady' });
 
-				sdk.eventBus.on('messenger:messageSent', (data) => {
+				sdk.eventBus.on('webChat:messageSent', (data) => {
 					callback({ action: 'messageSent', message: data });
 				});
 
-				sdk.eventBus.on('messenger:opened', () => {
-					callback({ action: 'messengerOpened' });
+				sdk.eventBus.on('webChat:opened', () => {
+					callback({ action: 'webChatOpened' });
 				});
 
-				sdk.eventBus.on('messenger:closed', () => {
-					callback({ action: 'messengerClosed' });
+				sdk.eventBus.on('webChat:closed', () => {
+					callback({ action: 'webChatClosed' });
 				});
 			}
 
-			// Listen for data-product7-messenger clicks
-			Product7._setupMessengerAttributeTriggers();
+			// Listen for data-product7-web-chat clicks
+			Product7._setupWebChatAttributeTriggers();
 			Product7._setupPostMessageListener();
 
 			return widget;
 		} catch (error) {
-			console.error('[Product7] Failed to initialize messenger widget:', error);
+			console.error('[Product7] Failed to initialize web chat widget:', error);
 			if (typeof callback === 'function') callback({ action: 'error', error });
 			return null;
 		}
 	},
 
-	openMessenger() {
-		if (Product7._messengerWidget) {
-			Product7._messengerWidget.open?.() ||
-				Product7._messengerWidget.openPanel?.();
+	openWebChat() {
+		if (Product7._WebChatWidget) {
+			Product7._WebChatWidget.open?.() || Product7._WebChatWidget.openPanel?.();
 		}
 	},
 
-	closeMessenger() {
-		if (Product7._messengerWidget) {
-			Product7._messengerWidget.close?.() ||
-				Product7._messengerWidget.closePanel?.();
+	closeWebChat() {
+		if (Product7._WebChatWidget) {
+			Product7._WebChatWidget.close?.() ||
+				Product7._WebChatWidget.closePanel?.();
 		}
 	},
 
-	destroyMessenger() {
-		if (Product7._messengerWidget) {
-			Product7._messengerWidget.destroy();
-			Product7._messengerWidget = null;
+	destroyWebChat() {
+		if (Product7._WebChatWidget) {
+			Product7._WebChatWidget.destroy();
+			Product7._WebChatWidget = null;
 		}
 	},
 
@@ -732,7 +731,7 @@ const Product7 = {
 
 	destroy() {
 		Product7.destroyFeedback();
-		Product7.destroyMessenger();
+		Product7.destroyWebChat();
 		Product7.destroySurvey();
 		if (Product7._sdk) {
 			Product7._sdk.destroy();
@@ -742,7 +741,7 @@ const Product7 = {
 		Product7._organization = null;
 		Product7._q = [];
 		Product7._feedbackListenerAttached = false;
-		Product7._messengerListenerAttached = false;
+		Product7._webChatListenerAttached = false;
 		Product7._postMessageListenerAttached = false;
 	},
 
@@ -773,16 +772,16 @@ const Product7 = {
 		});
 	},
 
-	_setupMessengerAttributeTriggers() {
+	_setupWebChatAttributeTriggers() {
 		if (typeof document === 'undefined') return;
-		if (Product7._messengerListenerAttached) return;
-		Product7._messengerListenerAttached = true;
+		if (Product7._webChatListenerAttached) return;
+		Product7._webChatListenerAttached = true;
 
 		document.addEventListener('click', (e) => {
-			const trigger = e.target.closest('[data-product7-messenger]');
+			const trigger = e.target.closest('[data-product7-web-chat]');
 			if (trigger) {
 				e.preventDefault();
-				Product7.openMessenger();
+				Product7.openWebChat();
 			}
 		});
 	},
@@ -803,11 +802,11 @@ const Product7 = {
 				case 'closeFeedback':
 					Product7.closeFeedback();
 					break;
-				case 'openMessenger':
-					Product7.openMessenger();
+				case 'openWebChat':
+					Product7.openWebChat();
 					break;
-				case 'closeMessenger':
-					Product7.closeMessenger();
+				case 'closeWebChat':
+					Product7.closeWebChat();
 					break;
 				case 'closeSurvey':
 					Product7.closeSurvey();
@@ -824,7 +823,7 @@ const Product7 = {
 	TabWidget,
 	InlineWidget,
 	SurveyWidget,
-	MessengerWidget,
+	WebChatWidget,
 	WidgetFactory,
 	EventBus,
 	APIService,
@@ -860,12 +859,12 @@ export {
 	EventBus,
 	helpers,
 	InlineWidget,
-	MessengerWidget,
 	Product7SDK as Product7,
 	SDKError,
 	SurveyWidget,
 	TabWidget,
 	ValidationError,
+	WebChatWidget,
 	WidgetError,
 	WidgetFactory,
 };

package/src/styles/base.js

@@ -1,6 +1,6 @@
-export const baseStyles = `
+export const baseStyles = `
 .feedback-widget,
-.messenger-widget,
+.web-chat-widget,
 .changelog-widget,
 .feedback-survey,
 .feedback-panel,
@@ -15,9 +15,9 @@ export const baseStyles = `
 .feedback-widget *,
 .feedback-widget *::before,
 .feedback-widget *::after,
-.messenger-widget *,
-.messenger-widget *::before,
-.messenger-widget *::after,
+.web-chat-widget *,
+.web-chat-widget *::before,
+.web-chat-widget *::after,
 .changelog-widget *,
 .changelog-widget *::before,
 .changelog-widget *::after,
@@ -41,7 +41,7 @@ export const baseStyles = `
 
 @media (prefers-reduced-motion: reduce) {
   .feedback-widget *,
-  .messenger-widget *,
+  .web-chat-widget *,
   .changelog-widget *,
   .feedback-survey * {
     transition: none !important;
@@ -56,9 +56,9 @@ export const baseStyles = `
   .sdk-notification,
   .changelog-widget,
   .changelog-modal,
-  .messenger-widget,
-  .messenger-launcher,
-  .messenger-panel,
+  .web-chat-widget,
+  .web-chat-launcher,
+  .web-chat-panel,
   .feedback-survey,
   .feedback-survey-backdrop {
     display: none !important;

package/src/styles/design-tokens.js

@@ -1,4 +1,4 @@
-export const designTokens = `
+export const designTokens = `
 :root {
   --color-primary: #155EEF;
   --color-primary-hover: #1249CA;
@@ -41,7 +41,7 @@ export const designTokens = `
   --color-text-secondary: #4B5563;
   --color-text-tertiary: #6B7280;
 
-  /* Messenger semantic tokens (light defaults) */
+  /* Web Chat semantic tokens (light defaults) */
   --msg-bg: #FFFFFF;
   --msg-bg-surface: #F3F4F6;
   --msg-bg-elevated: #FFFFFF;

package/src/styles/feedback.js

@@ -1,4 +1,4 @@
-export const feedbackStyles = `
+export const feedbackStyles = `
 .feedback-widget-button {
   position: fixed;
   z-index: var(--z-notification);
@@ -246,7 +246,7 @@ export const feedbackStyles = `
 
 .feedback-panel.theme-dark,
 .feedback-modal.theme-dark {
-  /* Aligned with messenger dark theme */
+  /* Aligned with web chat dark theme */
   --color-white: #0f1317;
   --color-background: #0f1317;
   --color-surface: #1a1e24;