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

apps/meteor/server/lib/cloud/version-check/functions/buildVersionUpdateMessage.spec.ts

@@ -0,0 +1,123 @@
+import { buildVersionUpdateMessage } from './buildVersionUpdateMessage';
+import { sendMessagesToAdmins } from '../../../sendMessagesToAdmins';
+
+const originalTestMode = process.env.TEST_MODE;
+
+const mockInfoVersion = jest.fn(() => '7.5.0');
+
+jest.mock('../../../../../app/utils/rocketchat.info', () => ({
+	Info: {
+		get version() {
+			return mockInfoVersion();
+		},
+	},
+}));
+
+const mockSetBannersInBulk = jest.fn();
+const mockFindUsersInRolesWithQuery = jest.fn();
+
+jest.mock('@rocket.chat/models', () => ({
+	Settings: {
+		updateValueById: jest.fn().mockResolvedValue({ modifiedCount: 0 }),
+	},
+	Users: {
+		findUsersInRolesWithQuery: () => mockFindUsersInRolesWithQuery(),
+		setBannersInBulk: (updates: unknown) => mockSetBannersInBulk(updates),
+	},
+}));
+
+const mockSettingsGet = jest.fn();
+
+jest.mock('../../../../settings', () => ({
+	settings: {
+		get: (key: string) => mockSettingsGet(key),
+	},
+}));
+
+jest.mock('../../../i18n', () => ({
+	i18n: {
+		t: jest.fn((key) => key),
+	},
+}));
+
+jest.mock('../../../sendMessagesToAdmins', () => ({
+	sendMessagesToAdmins: jest.fn(),
+}));
+
+jest.mock('../../../../settings/lib/auditedSettingUpdates', () => ({
+	updateAuditedBySystem: jest.fn(() => () => Promise.resolve({ modifiedCount: 0 })),
+}));
+
+jest.mock('../../../notifyListener', () => ({
+	notifyOnSettingChangedById: jest.fn(),
+}));
+
+describe('buildVersionUpdateMessage', () => {
+	// Delete the TEST_MODE environment variable so buildVersionUpdateMessage()
+	// doesn't return early (see line 40 in buildVersionUpdateMessage.ts)
+	beforeAll(() => {
+		delete process.env.TEST_MODE;
+	});
+
+	afterAll(() => {
+		process.env.TEST_MODE = originalTestMode;
+	});
+
+	beforeEach(() => {
+		jest.clearAllMocks();
+		mockInfoVersion.mockReturnValue('7.5.0');
+		mockSettingsGet.mockReturnValue('7.0.0');
+	});
+
+	describe('cleanupOutdatedVersionUpdateBanners', () => {
+		it('should remove outdated version banners (<= current installed)', async () => {
+			const admin = { _id: 'admin1', banners: { 'versionUpdate-6_2_0': { id: 'versionUpdate-6_2_0' } } };
+			mockFindUsersInRolesWithQuery.mockReturnValue([admin]);
+
+			await buildVersionUpdateMessage([]);
+
+			expect(mockSetBannersInBulk).toHaveBeenCalledWith([{ userId: 'admin1', banners: {} }]);
+		});
+
+		it('should keep version banners > current installed', async () => {
+			const admin = { _id: 'admin1', banners: { 'versionUpdate-8_0_0': { id: 'versionUpdate-8_0_0' } } };
+			mockFindUsersInRolesWithQuery.mockReturnValue([admin]);
+
+			await buildVersionUpdateMessage([]);
+
+			expect(mockSetBannersInBulk).not.toHaveBeenCalled();
+		});
+
+		it('should remove banners with invalid semver version IDs', async () => {
+			const admin = { _id: 'admin1', banners: { 'versionUpdate-invalid_version': { id: 'versionUpdate-invalid_version' } } };
+			mockFindUsersInRolesWithQuery.mockReturnValue([admin]);
+
+			await buildVersionUpdateMessage([]);
+
+			expect(mockSetBannersInBulk).toHaveBeenCalledWith([{ userId: 'admin1', banners: {} }]);
+		});
+	});
+
+	describe('version sorting', () => {
+		it('should process versions in descending order (highest first)', async () => {
+			mockFindUsersInRolesWithQuery.mockReturnValue([]);
+
+			await buildVersionUpdateMessage([
+				{ version: '7.6.0', security: false, infoUrl: 'https://example.com/7.6.0' },
+				{ version: '8.0.0', security: false, infoUrl: 'https://example.com/8.0.0' },
+				{ version: '7.8.0', security: false, infoUrl: 'https://example.com/7.8.0' },
+			]);
+
+			expect(sendMessagesToAdmins).toHaveBeenCalledTimes(1);
+			expect(sendMessagesToAdmins).toHaveBeenCalledWith(
+				expect.objectContaining({
+					banners: expect.arrayContaining([
+						expect.objectContaining({
+							id: 'versionUpdate-8_0_0',
+						}),
+					]),
+				}),
+			);
+		});
+	});
+});