snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

apps/meteor/server/lib/omnichannel/tracking.ts

@@ -0,0 +1,54 @@
+import { Message } from '@rocket.chat/core-services';
+import { Users } from '@rocket.chat/models';
+
+import { livechatLogger } from './logger';
+import { settings } from '../../settings';
+
+type PageInfo = { title: string; location: { href: string }; change: string };
+
+export async function savePageHistory(token: string, roomId: string | undefined, pageInfo: PageInfo) {
+	livechatLogger.debug({
+		msg: `Saving page movement history for visitor with token ${token}`,
+		pageInfo,
+		roomId,
+	});
+
+	if (pageInfo.change !== settings.get<string>('Livechat_history_monitor_type')) {
+		return;
+	}
+	const user = await Users.findOneById('rocket.cat');
+
+	if (!user) {
+		throw new Error('error-invalid-user');
+	}
+
+	const pageTitle = pageInfo.title;
+	const pageUrl = pageInfo.location.href;
+	const extraData: {
+		navigation: {
+			page: PageInfo;
+			token: string;
+		};
+		expireAt?: number;
+		_hidden?: boolean;
+	} = {
+		navigation: {
+			page: pageInfo,
+			token,
+		},
+	};
+
+	if (!roomId) {
+		livechatLogger.warn({ msg: 'Saving page history without room id for visitor', token });
+		// keep history of unregistered visitors for 1 month
+		const keepHistoryMiliseconds = 2592000000;
+		extraData.expireAt = new Date().getTime() + keepHistoryMiliseconds;
+	}
+
+	if (!settings.get('Livechat_Visitor_navigation_as_a_message')) {
+		extraData._hidden = true;
+	}
+
+	// @ts-expect-error: Investigating on which case we won't receive a roomId and where that history is supposed to be stored
+	return Message.saveSystemMessage('livechat_navigation_history', roomId, `${pageTitle} - ${pageUrl}`, user, extraData);
+}