@product7/feedback-sdk 1.6.4 → 1.6.6

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

@@ -2203,6 +2203,13 @@
 		}
 
 		_render() {
+			const buttonText =
+				this.options.buttonText ||
+				this.options.triggerText ||
+				this.options.label ||
+				this.options.text ||
+				'Feedback';
+
 			const button = document.createElement('div');
 			button.className = `feedback-widget-button position-${this.options.position}`;
 			button.innerHTML = `
@@ -2210,7 +2217,7 @@
         <svg class="feedback-icon" width="20" height="20" viewBox="0 0 256 256" fill="currentColor">
           <path d="M216,80H184V48a16,16,0,0,0-16-16H40A16,16,0,0,0,24,48V176a8,8,0,0,0,13,6.22L72,154V184a16,16,0,0,0,16,16h93.59L219,230.22a8,8,0,0,0,5,1.78,8,8,0,0,0,8-8V96A16,16,0,0,0,216,80ZM66.55,137.78,40,159.25V48H168v88H71.58A8,8,0,0,0,66.55,137.78ZM216,207.25l-26.55-21.47a8,8,0,0,0-5-1.78H88V152h80a16,16,0,0,0,16-16V96h32Z"/>
         </svg>
-        <span class="feedback-text">Feedback</span>
+        <span class="feedback-text">${buttonText}</span>
         
         <div class="feedback-minimize-icon">
           <svg viewBox="0 0 256 256">
@@ -5895,6 +5902,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',
@@ -5907,7 +5919,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,
@@ -6375,6 +6390,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();
@@ -6701,17 +6761,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() {
@@ -8087,12 +8158,15 @@
 			}
 
 			const widgetId = generateId('widget');
+			const widgetConfig = this._getWidgetTypeConfig(type);
+			const explicitOptions = this._omitUndefined(options);
 			const widgetOptions = {
 				id: widgetId,
 				sdk: this,
 				apiService: this.apiService,
 				...this.config,
-				...options,
+				...widgetConfig,
+				...explicitOptions,
 			};
 
 			try {
@@ -8204,13 +8278,22 @@
 			}
 
 			const normalizedOptions = this._normalizeSurveyConfig(options);
+			const surveyConfigDefaults = this._getWidgetTypeConfig('survey');
 
 			const surveyWidget = this.createWidget('survey', {
 				surveyId: normalizedOptions.surveyId,
 				surveyType:
 					normalizedOptions.surveyType || normalizedOptions.type || 'nps',
-				position: normalizedOptions.position || 'bottom-right',
-				theme: normalizedOptions.theme || this.config.theme || 'light',
+				position:
+					normalizedOptions.position ??
+					surveyConfigDefaults.position ??
+					this.config.position ??
+					'bottom-right',
+				theme:
+					normalizedOptions.theme ??
+					surveyConfigDefaults.theme ??
+					this.config.theme ??
+					'light',
 				title: normalizedOptions.title,
 				description: normalizedOptions.description,
 				lowLabel: normalizedOptions.lowLabel,
@@ -8413,6 +8496,58 @@
 			return null;
 		}
 
+		_getWidgetTypeConfig(type) {
+			const widgetsConfig = this._isPlainObject(this.config?.widgets)
+				? this.config.widgets
+				: {};
+
+			const legacyTypeConfig = this._isPlainObject(this.config?.[type])
+				? this.config[type]
+				: {};
+
+			const namespacedTypeConfig = this._isPlainObject(widgetsConfig?.[type])
+				? widgetsConfig[type]
+				: {};
+
+			const mergedTypeConfig = deepMerge(legacyTypeConfig, namespacedTypeConfig);
+			return this._toCamelCaseObject(mergedTypeConfig);
+		}
+
+		_isPlainObject(value) {
+			return Object.prototype.toString.call(value) === '[object Object]';
+		}
+
+		_toCamelCaseKey(key) {
+			return key.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+		}
+
+		_toCamelCaseObject(value) {
+			if (Array.isArray(value)) {
+				return value.map((item) => this._toCamelCaseObject(item));
+			}
+
+			if (!this._isPlainObject(value)) {
+				return value;
+			}
+
+			const normalized = {};
+			for (const [key, nestedValue] of Object.entries(value)) {
+				normalized[this._toCamelCaseKey(key)] =
+					this._toCamelCaseObject(nestedValue);
+			}
+			return normalized;
+		}
+
+		_omitUndefined(value) {
+			if (!this._isPlainObject(value)) {
+				return value;
+			}
+
+			return Object.fromEntries(
+				Object.entries(value).filter(([, nestedValue]) => nestedValue !== undefined)
+			);
+		}
+
 		showChangelog(options = {}) {
 			if (!this.initialized) {
 				throw new SDKError(
@@ -8420,16 +8555,22 @@
 				);
 			}
 
+			const defaults = {
+				position: this.config.position || 'bottom-right',
+				theme: this.config.theme || 'light',
+				title: "What's New",
+				triggerText: "What's New",
+				showBadge: true,
+				viewButtonText: 'View Update',
+			};
+
+			const configDefaults = this._getWidgetTypeConfig('changelog');
+			const explicitOptions = this._omitUndefined(options);
+
 			const changelogWidget = this.createWidget('changelog', {
-				position: options.position || 'bottom-right',
-				theme: options.theme || this.config.theme || 'light',
-				title: options.title || "What's New",
-				triggerText: options.triggerText || "What's New",
-				showBadge: options.showBadge !== false,
-				viewButtonText: options.viewButtonText || 'View Update',
-				changelogBaseUrl: options.changelogBaseUrl,
-				openInNewTab: options.openInNewTab,
-				onViewUpdate: options.onViewUpdate,
+				...defaults,
+				...configDefaults,
+				...explicitOptions,
 			});
 
 			changelogWidget.mount();