test(i18n): add unit tests for languageApi and languageManager functions

Author: Ang-m4

src/i18n/languageApi.test.js

@@ -0,0 +1,45 @@
+import { updateUserPreferences, setSessionLanguage } from './languageApi';
+import { getConfig } from '../config';
+import { getAuthenticatedHttpClient } from '../auth';
+
+jest.mock('../config');
+jest.mock('../auth');
+
+const LMS_BASE_URL = 'http://test.lms';
+
+describe('languageApi', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    getConfig.mockReturnValue({ LMS_BASE_URL });
+  });
+
+  describe('updateUserPreferences', () => {
+    it('should send a PATCH request with correct data', async () => {
+      const patchMock = jest.fn().mockResolvedValue({});
+      getAuthenticatedHttpClient.mockReturnValue({ patch: patchMock });
+
+      await updateUserPreferences('user1', { prefLang: 'es' });
+
+      expect(patchMock).toHaveBeenCalledWith(
+        `${LMS_BASE_URL}/api/user/v1/preferences/user1`,
+        expect.any(Object),
+        expect.objectContaining({ headers: expect.any(Object) }),
+      );
+    });
+  });
+
+  describe('setSessionLanguage', () => {
+    it('should send a POST request to setlang endpoint', async () => {
+      const postMock = jest.fn().mockResolvedValue({});
+      getAuthenticatedHttpClient.mockReturnValue({ post: postMock });
+
+      await setSessionLanguage('ar');
+
+      expect(postMock).toHaveBeenCalledWith(
+        `${LMS_BASE_URL}/i18n/setlang/`,
+        expect.any(FormData),
+        expect.objectContaining({ headers: expect.any(Object) }),
+      );
+    });
+  });
+});

src/i18n/languageManager.test.js

@@ -0,0 +1,82 @@
+import { changeUserSessionLanguage } from './languageManager';
+import { getConfig } from '../config';
+import { getAuthenticatedUser } from '../auth';
+import { getCookies, handleRtl, LOCALE_CHANGED } from './lib';
+import { logError } from '../logging';
+import { publish } from '../pubSub';
+import { updateUserPreferences, setSessionLanguage } from './languageApi';
+
+jest.mock('../config');
+jest.mock('../auth');
+jest.mock('./lib');
+jest.mock('../logging');
+jest.mock('../pubSub');
+jest.mock('./languageApi');
+
+const LMS_BASE_URL = 'http://test.lms';
+const LANGUAGE_PREFERENCE_COOKIE_NAME = 'lang';
+
+describe('languageManager', () => {
+  let mockCookies;
+  let mockUser;
+  let mockReload;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    getConfig.mockReturnValue({
+      LMS_BASE_URL,
+      LANGUAGE_PREFERENCE_COOKIE_NAME,
+    });
+
+    mockCookies = { set: jest.fn() };
+    getCookies.mockReturnValue(mockCookies);
+
+    mockUser = { username: 'testuser', userId: '123' };
+    getAuthenticatedUser.mockReturnValue(mockUser);
+
+    mockReload = jest.fn();
+    Object.defineProperty(window, 'location', {
+      configurable: true,
+      writable: true,
+      value: { reload: mockReload },
+    });
+
+    updateUserPreferences.mockResolvedValue({});
+    setSessionLanguage.mockResolvedValue({});
+  });
+
+  describe('changeUserSessionLanguage', () => {
+    it('should perform complete language change process', async () => {
+      await changeUserSessionLanguage('fr');
+
+      expect(getCookies().set).toHaveBeenCalledWith(
+        LANGUAGE_PREFERENCE_COOKIE_NAME,
+        'fr',
+      );
+      expect(updateUserPreferences).toHaveBeenCalledWith('testuser', {
+        prefLang: 'fr',
+      });
+      expect(setSessionLanguage).toHaveBeenCalledWith('fr');
+      expect(handleRtl).toHaveBeenCalledWith('fr');
+      expect(publish).toHaveBeenCalledWith(LOCALE_CHANGED, 'fr');
+      expect(mockReload).not.toHaveBeenCalled();
+    });
+
+    it('should handle errors gracefully', async () => {
+      updateUserPreferences.mockRejectedValue(new Error('fail'));
+      await changeUserSessionLanguage('es', true);
+      expect(logError).toHaveBeenCalled();
+    });
+
+    it('should skip updateUserPreferences if user is not authenticated', async () => {
+      getAuthenticatedUser.mockReturnValue(null);
+      await changeUserSessionLanguage('en', true);
+      expect(updateUserPreferences).not.toHaveBeenCalled();
+    });
+
+    it('should reload if forceReload is true', async () => {
+      await changeUserSessionLanguage('de', true);
+      expect(mockReload).toHaveBeenCalled();
+    });
+  });
+});