Free standing functions cannot be stubbed

It turns out that you can no longer stub free-standing functions in Typescript 3.9.2+ according to this issue:

microsoft/TypeScript#38568
sinonjs/sinon#562

The solution is to make an object, FacultyAPI, that contains those functions and export the object instead of the functions themselves

Author: natalynyu

src/client/api/__tests__/faculty.test.ts

@@ -10,7 +10,7 @@ import {
   newAppliedPhysicsFacultyMember,
   bioengineeringFacultyMember,
 } from 'testData';
-import * as api from 'client/api';
+import { FacultyAPI } from 'client/api';
 import { ManageFacultyResponseDTO } from 'common/dto/faculty/ManageFacultyResponse.dto';
 import {
   strictEqual,
@@ -44,7 +44,8 @@ describe('Faculty API', function () {
               ],
             },
           });
-          const response = await api.getFacultySchedulesForYear(acadYear);
+          const response = await FacultyAPI
+            .getFacultySchedulesForYear(acadYear);
           result = response[acadYear][0];
         });
         it('should call getAllFacultySchedules', function () {
@@ -64,7 +65,7 @@ describe('Faculty API', function () {
         });
         it('should throw an error', async function () {
           try {
-            await api.getAllFacultyMembers();
+            await FacultyAPI.getAllFacultyMembers();
             fail('Did not throw an error');
           } catch (err) {
             strictEqual(err, error);
@@ -97,7 +98,7 @@ describe('Faculty Admin API', function () {
               bioengineeringFacultyMemberResponse,
             ],
           } as AxiosResponse<ManageFacultyResponseDTO[]>);
-          getFacultyResult = await api.getAllFacultyMembers();
+          getFacultyResult = await FacultyAPI.getAllFacultyMembers();
         });
         it('should call getAllFacultyMembers', function () {
           strictEqual(getStub.callCount, 1);
@@ -120,7 +121,7 @@ describe('Faculty Admin API', function () {
         });
         it('should throw an error', async function () {
           try {
-            await api.getAllFacultyMembers();
+            await FacultyAPI.getAllFacultyMembers();
             fail('Did not throw an error');
           } catch (err) {
             deepStrictEqual(err, error);
@@ -141,7 +142,7 @@ describe('Faculty Admin API', function () {
         postStub.resolves({
           data: physicsFacultyMemberResponse,
         } as AxiosResponse<ManageFacultyResponseDTO>);
-        createFacultyResult = await api
+        createFacultyResult = await FacultyAPI
           .createFaculty(newAppliedPhysicsFacultyMember);
       });
       it('should call createFaculty', function () {
@@ -161,7 +162,7 @@ describe('Faculty Admin API', function () {
       });
       it('should throw an error', async function () {
         try {
-          await api.createFaculty(newAppliedPhysicsFacultyMember);
+          await FacultyAPI.createFaculty(newAppliedPhysicsFacultyMember);
           fail('Did not throw an error');
         } catch (err) {
           deepStrictEqual(err, error);
@@ -190,7 +191,7 @@ describe('Faculty Admin API', function () {
         putStub.resolves({
           data: editedFacultyMemberResponse,
         } as AxiosResponse<ManageFacultyResponseDTO>);
-        editFacultyResult = await api
+        editFacultyResult = await FacultyAPI
           .editFaculty(editedFacultyMember);
       });
       it('should call editFaculty', function () {
@@ -213,7 +214,7 @@ describe('Faculty Admin API', function () {
       });
       it('should throw an error', async function () {
         try {
-          await api.editFaculty(bioengineeringFacultyMember);
+          await FacultyAPI.editFaculty(bioengineeringFacultyMember);
           fail('Did not throw an error');
         } catch (err) {
           deepStrictEqual(err, error);

src/client/api/faculty.ts

@@ -7,7 +7,7 @@ import request from './request';
 /**
  * Retrieves all faculty for the Faculty Admin tab
  */
-export const getAllFacultyMembers = async ():
+const getAllFacultyMembers = async ():
 Promise<ManageFacultyResponseDTO[]> => {
   const response = await request.get('/api/faculty/');
   return response.data as ManageFacultyResponseDTO[];
@@ -16,7 +16,7 @@ Promise<ManageFacultyResponseDTO[]> => {
 /**
  * Submits a POST request to create a new faculty for the Faculty Admin tab
  */
-export const createFaculty = async (facultyInfo: CreateFacultyDTO):
+const createFaculty = async (facultyInfo: CreateFacultyDTO):
 Promise<ManageFacultyResponseDTO> => {
   const response = await request.post('/api/faculty', facultyInfo);
   return response.data;
@@ -25,7 +25,7 @@ Promise<ManageFacultyResponseDTO> => {
 /**
  * Edit an existing faculty member entry
  */
-export const editFaculty = async (facultyInfo: UpdateFacultyDTO):
+const editFaculty = async (facultyInfo: UpdateFacultyDTO):
 Promise<ManageFacultyResponseDTO> => {
   const response = await request.put(`/api/faculty/${facultyInfo.id}`, facultyInfo);
   return response.data;
@@ -35,7 +35,7 @@ Promise<ManageFacultyResponseDTO> => {
  * Retrieves faculty schedule information for the Faculty tab for specified
  * academic year(s)
  */
-export const getFacultySchedulesForYear = async (
+const getFacultySchedulesForYear = async (
   acadYears: number
 ):
 Promise<Record<string, FacultyResponseDTO[]>> => {

src/client/components/pages/FacultyAdmin.tsx

@@ -42,12 +42,8 @@ import {
   categoryEnumToTitleCase,
   sortFaculty,
 } from 'common/__tests__/utils/facultyHelperFunctions';
-import {
-  getAllFacultyMembers,
-  createFaculty,
-  editFaculty,
-} from '../../api/faculty';
 import { getAreaColor } from '../../../common/constants';
+import { FacultyAPI } from '../../api/faculty';
 
 /**
  * The component represents the Faculty Admin page, which will be rendered at
@@ -74,9 +70,10 @@ const FacultyAdmin: FunctionComponent = function (): ReactElement {
    * If it fails, display a message for the user
    */
   useEffect((): void => {
-    getAllFacultyMembers()
-      .then((facultyMembers) => {
+    FacultyAPI.getAllFacultyMembers()
+      .then((facultyMembers): ManageFacultyResponseDTO[] => {
         setFacultyMembers(facultyMembers);
+        return facultyMembers;
       })
       .catch((): void => {
         dispatchMessage({
@@ -255,7 +252,7 @@ const FacultyAdmin: FunctionComponent = function (): ReactElement {
     if (!createFacultyFirstName && !createFacultyLastName) {
       throw new Error('At least a first or last name must be provided for a faculty member. Please try again.');
     }
-    return createFaculty({
+    return FacultyAPI.createFaculty({
       area: createFacultyArea,
       HUID: createFacultyHUID,
       firstName: createFacultyFirstName,
@@ -284,7 +281,7 @@ const FacultyAdmin: FunctionComponent = function (): ReactElement {
     if (!editFacultyFirstName && !editFacultyLastName) {
       throw new Error('At least a first or last name must be provided for a faculty member. Please try again.');
     }
-    return editFaculty({
+    return FacultyAPI.editFaculty({
       id: currentFaculty.id,
       area: editFacultyArea,
       HUID: editFacultyHUID,