@product7/feedback-sdk 1.6.5 → 1.6.7

package/README.md

@@ -439,6 +439,10 @@ messenger.mount();
 | `welcomeMessage`   | string   | 'How can we help?' | Welcome message on home view            |
 | `enableHelp`       | boolean  | true               | Show help articles section              |
 | `enableChangelog`  | boolean  | true               | Show changelog section                  |
+| `enableNews`       | boolean  | -                  | Alias for `enableChangelog`             |
+| `autoLoadData`     | boolean  | true               | Auto-fetch conversations/help/changelog |
+| `initialView`      | string   | 'home'             | Initial view on mount                   |
+| `previewData`      | object   | null               | Seed deterministic local data           |
 | `logoUrl`          | string   | -                  | Custom logo URL                         |
 | `primaryColor`     | string   | '#155EEF'          | Primary accent color                    |
 | `onSendMessage`    | function | null               | Callback when message is sent           |

package/dist/README.md

@@ -439,6 +439,10 @@ messenger.mount();
 | `welcomeMessage`   | string   | 'How can we help?' | Welcome message on home view            |
 | `enableHelp`       | boolean  | true               | Show help articles section              |
 | `enableChangelog`  | boolean  | true               | Show changelog section                  |
+| `enableNews`       | boolean  | -                  | Alias for `enableChangelog`             |
+| `autoLoadData`     | boolean  | true               | Auto-fetch conversations/help/changelog |
+| `initialView`      | string   | 'home'             | Initial view on mount                   |
+| `previewData`      | object   | null               | Seed deterministic local data           |
 | `logoUrl`          | string   | -                  | Custom logo URL                         |
 | `primaryColor`     | string   | '#155EEF'          | Primary accent color                    |
 | `onSendMessage`    | function | null               | Callback when message is sent           |

package/dist/feedback-sdk.js

@@ -921,15 +921,19 @@
 					body: JSON.stringify(payload),
 					headers: { 'Content-Type': 'application/json' },
 				});
+				const initData = this._extractInitResponseData(response);
 
-				this.sessionToken = response.session_token;
-				this.sessionExpiry = new Date(Date.now() + response.expires_in * 1000);
+				this.sessionToken = initData.sessionToken;
+				this.sessionExpiry = new Date(Date.now() + initData.expiresIn * 1000);
 				this._storeSession();
 
 				return {
 					sessionToken: this.sessionToken,
-					config: response.config || {},
-					expiresIn: response.expires_in,
+					config: initData.config,
+					expiresIn: initData.expiresIn,
+					status: initData.status,
+					message: initData.message,
+					configVersion: initData.configVersion,
 				};
 			} catch (error) {
 				throw new APIError$1(
@@ -940,6 +944,34 @@
 			}
 		}
 
+		_extractInitResponseData(response) {
+			const payload =
+				response && typeof response.data === 'object' ? response.data : response || {};
+
+			const sessionToken = payload.session_token || payload.sessionToken;
+			const expiresIn = Number(payload.expires_in ?? payload.expiresIn);
+
+			if (!sessionToken) {
+				throw new APIError$1(500, 'Invalid init response: missing session_token');
+			}
+
+			if (!Number.isFinite(expiresIn) || expiresIn <= 0) {
+				throw new APIError$1(500, 'Invalid init response: missing expires_in');
+			}
+
+			return {
+				sessionToken,
+				expiresIn,
+				config:
+					payload.config && typeof payload.config === 'object'
+						? payload.config
+						: {},
+				configVersion: payload.config_version ?? payload.configVersion ?? null,
+				status: response?.status ?? payload?.status ?? true,
+				message: response?.message ?? payload?.message ?? null,
+			};
+		}
+
 		async _ensureSession() {
 			if (!this.isSessionValid()) {
 				await this.init();
@@ -1725,6 +1757,15 @@
 		mount(container) {
 			if (this.mounted || this.destroyed) return this;
 
+			if (this.options.enabled === false) {
+				this.sdk.eventBus.emit('widget:suppressed', {
+					widget: this,
+					type: this.type,
+					reason: 'disabled',
+				});
+				return this;
+			}
+
 			if (this.options.suppressAfterSubmission && this._hasRecentlySubmitted()) {
 				this.sdk.eventBus.emit('widget:suppressed', {
 					widget: this,
@@ -5902,6 +5943,11 @@
 		constructor(options) {
 			super({ ...options, type: 'messenger' });
 
+			const resolvedEnableChangelog =
+				typeof options.enableChangelog === 'boolean'
+					? options.enableChangelog
+					: options.enableNews !== false;
+
 			this.messengerOptions = {
 				position: options.position || 'bottom-right',
 				theme: options.theme || 'light',
@@ -5914,7 +5960,10 @@
 				greetingMessage: options.greetingMessage || 'Hi there 👋',
 				welcomeMessage: options.welcomeMessage || 'How can we help?',
 				enableHelp: options.enableHelp !== false,
-				enableChangelog: options.enableChangelog !== false,
+				enableChangelog: resolvedEnableChangelog,
+				autoLoadData: options.autoLoadData !== false,
+				initialView: options.initialView || 'home',
+				previewData: options.previewData || null,
 				featuredContent: options.featuredContent || null,
 				feedbackUrl: options.feedbackUrl || null,
 				changelogUrl: options.changelogUrl || null,
@@ -6382,6 +6431,51 @@
 			};
 		}
 
+		_applyPreviewData() {
+			const data = this.messengerOptions.previewData;
+			if (!data || typeof data !== 'object') {
+				return;
+			}
+
+			if (Array.isArray(data.conversations)) {
+				this.messengerState.setConversations(data.conversations);
+			}
+
+			if (Array.isArray(data.helpArticles)) {
+				this.messengerState.setHelpArticles(data.helpArticles);
+			}
+
+			if (Array.isArray(data.homeChangelogItems)) {
+				this.messengerState.setHomeChangelogItems(data.homeChangelogItems);
+			}
+
+			if (Array.isArray(data.changelogItems)) {
+				this.messengerState.setChangelogItems(data.changelogItems);
+			}
+
+			if (typeof data.unreadCount === 'number') {
+				this.setUnreadCount(data.unreadCount);
+			}
+
+			if (data.availability && typeof data.availability === 'object') {
+				const availability = data.availability;
+				this.messengerState.agentsOnline = Boolean(
+					availability.agentsOnline ?? availability.agents_online
+				);
+				this.messengerState.onlineCount =
+					availability.onlineCount ?? availability.online_count ?? 0;
+				this.messengerState.responseTime =
+					availability.responseTime ??
+					availability.response_time ??
+					this.messengerState.responseTime;
+				this.messengerState._notify('availabilityUpdate', availability);
+			}
+
+			if (typeof data.currentView === 'string') {
+				this.messengerState.setView(data.currentView);
+			}
+		}
+
 		async loadInitialData() {
 			try {
 				const conversations = await this._fetchConversations();
@@ -6708,17 +6802,28 @@
 		}
 
 		async onMount() {
-			this.loadInitialData();
+			this._applyPreviewData();
 
-			if (this.apiService?.sessionToken) {
-				this._initWebSocket();
-			}
+			if (this.messengerOptions.autoLoadData) {
+				this.loadInitialData();
 
-			this.checkAgentAvailability();
+				if (this.apiService?.sessionToken) {
+					this._initWebSocket();
+				}
 
-			this._availabilityInterval = setInterval(() => {
 				this.checkAgentAvailability();
-			}, 60000);
+
+				this._availabilityInterval = setInterval(() => {
+					this.checkAgentAvailability();
+				}, 60000);
+			}
+
+			if (
+				this.messengerOptions.initialView &&
+				this.messengerOptions.initialView !== this.messengerState.currentView
+			) {
+				this.messengerState.setView(this.messengerOptions.initialView);
+			}
 		}
 
 		onDestroy() {
@@ -6760,6 +6865,8 @@
 				surveyId: options.surveyId || null,
 				surveyType: options.surveyType || 'nps',
 				position: options.position || 'bottom-right',
+				enabled:
+					typeof options.enabled === 'boolean' ? options.enabled : undefined,
 				title: options.title || null,
 				description: options.description || null,
 				lowLabel: options.lowLabel || null,
@@ -6813,6 +6920,15 @@
 		}
 
 		show() {
+			if (this.options.enabled === false || this.surveyOptions.enabled === false) {
+				this.sdk.eventBus.emit('survey:suppressed', {
+					widget: this,
+					surveyId: this.surveyOptions.surveyId,
+					reason: 'disabled',
+				});
+				return this;
+			}
+
 			this._renderSurvey();
 			this.surveyState.isVisible = true;
 			this.sdk.eventBus.emit('survey:shown', {
@@ -8096,6 +8212,10 @@
 			const widgetId = generateId('widget');
 			const widgetConfig = this._getWidgetTypeConfig(type);
 			const explicitOptions = this._omitUndefined(options);
+			const widgetEnabled = this._isWidgetEnabled(type, {
+				...widgetConfig,
+				...explicitOptions,
+			});
 			const widgetOptions = {
 				id: widgetId,
 				sdk: this,
@@ -8103,6 +8223,7 @@
 				...this.config,
 				...widgetConfig,
 				...explicitOptions,
+				enabled: widgetEnabled,
 			};
 
 			try {
@@ -8193,6 +8314,7 @@
 					surveyConfig.showDescription ?? surveyConfig.show_description,
 				customQuestions: surveyConfig.customQuestions || surveyConfig.questions,
 				pages: surveyConfig.pages,
+				enabled: surveyConfig.enabled,
 				...displayOptions,
 			});
 		}
@@ -8215,6 +8337,17 @@
 
 			const normalizedOptions = this._normalizeSurveyConfig(options);
 			const surveyConfigDefaults = this._getWidgetTypeConfig('survey');
+			const surveyEnabled = this._isWidgetEnabled('survey', normalizedOptions);
+
+			if (!surveyEnabled) {
+				this.eventBus.emit('survey:suppressed', {
+					surveyId:
+						normalizedOptions.surveyId || normalizedOptions.id || options.id || null,
+					reason: 'disabled',
+					survey: normalizedOptions,
+				});
+				return null;
+			}
 
 			const surveyWidget = this.createWidget('survey', {
 				surveyId: normalizedOptions.surveyId,
@@ -8246,6 +8379,7 @@
 				email: normalizedOptions.email,
 				onSubmit: normalizedOptions.onSubmit,
 				onDismiss: normalizedOptions.onDismiss,
+				enabled: surveyEnabled,
 			});
 
 			surveyWidget.mount();
@@ -8339,13 +8473,19 @@
 				: {};
 
 			const inferredType =
-				survey.type || this._inferSurveyTypeFromPage(firstPage) || 'nps';
+				survey.surveyType ||
+				survey.survey_type ||
+				survey.type ||
+				this._inferSurveyTypeFromPage(firstPage) ||
+				'nps';
 
 			return {
 				...survey,
-				surveyId: survey.surveyId || survey.id || null,
-				surveyType: survey.surveyType || inferredType,
-				type: survey.type || inferredType,
+				surveyId: survey.surveyId || survey.survey_id || survey.id || null,
+				surveyType: survey.surveyType || survey.survey_type || inferredType,
+				type: survey.type || survey.survey_type || inferredType,
+				enabled:
+					typeof survey.enabled === 'boolean' ? survey.enabled : undefined,
 				should_show:
 					survey.should_show ??
 					(survey.eligibility ? survey.eligibility.should_show : undefined),
@@ -8374,7 +8514,11 @@
 				showTitle: survey.showTitle ?? survey.show_title ?? null,
 				showDescription:
 					survey.showDescription ?? survey.show_description ?? null,
-				customQuestions: survey.customQuestions || survey.questions || [],
+				customQuestions:
+					survey.customQuestions ||
+					survey.custom_questions ||
+					survey.questions ||
+					[],
 				pages: this._normalizeSurveyPages(survey.pages || []),
 			};
 		}
@@ -8449,6 +8593,23 @@
 			return this._toCamelCaseObject(mergedTypeConfig);
 		}
 
+		_isWidgetEnabled(type, options = {}) {
+			const typeConfig = this._getWidgetTypeConfig(type);
+			if (typeConfig.enabled === false) {
+				return false;
+			}
+
+			if (typeof options.enabled === 'boolean') {
+				return options.enabled;
+			}
+
+			if (typeof typeConfig.enabled === 'boolean') {
+				return typeConfig.enabled;
+			}
+
+			return true;
+		}
+
 		_isPlainObject(value) {
 			return Object.prototype.toString.call(value) === '[object Object]';
 		}
@@ -8502,11 +8663,21 @@
 
 			const configDefaults = this._getWidgetTypeConfig('changelog');
 			const explicitOptions = this._omitUndefined(options);
+			const changelogEnabled = this._isWidgetEnabled('changelog', explicitOptions);
+
+			if (!changelogEnabled) {
+				this.eventBus.emit('widget:suppressed', {
+					type: 'changelog',
+					reason: 'disabled',
+				});
+				return null;
+			}
 
 			const changelogWidget = this.createWidget('changelog', {
 				...defaults,
 				...configDefaults,
 				...explicitOptions,
+				enabled: changelogEnabled,
 			});
 
 			changelogWidget.mount();