Coffee Chat Archive/Unarchive Button (#872)

### Summary <!-- Required -->

<!-- Provide a general summary of your changes in the Title above -->
<!-- Itemize bug fixes, new features, and other changes -->
<!-- Feel free to break this into sub-sections, i.e. features, fixes,
etc. -->
<!-- Some examples are shown below. -->

This PR adds the functionality for Admins to be able to both Archive and
Unarchive all coffee chats to give a clean slate for every semester.

- [x] Added `archiveCoffeeChats` and `unarchiveCoffeeChats` to
`CoffeeChatDao.ts`
- [x] Added endpoints for both archive/unarchive in `api.ts` and
`loginCheckedPatch` for patch REST
- [x] Added functions for both the backend/frontend `coffeeChatAPI.ts`
and `CoffeeChatAPI.ts`
- [x] Created patch Request in the `APIWrapper.ts`
- [x] Added Archive/Unarchive buttons to `CoffeeChats.tsx` (Gives
success alert once finished!)

<!-- If the changes have associated Notion pages/Figma design(s), please
include the links here.-->
[Notion
Link](https://www.notion.so/Coffee-Chat-Add-Ability-for-Admin-to-Archive-Coffee-Chats-1890ad723ce181319b34feaebe6c782d?pvs=4)

### Test Plan <!-- Required -->


https://github.com/user-attachments/assets/36a6885f-0343-45bd-aa20-2ed93cfaaf22

<!-- Provide screenshots or point out the additional unit tests -->

backend/src/API/coffeeChatAPI.ts

@@ -138,6 +138,22 @@ export const clearAllCoffeeChats = async (user: IdolMember): Promise<void> => {
   await CoffeeChatDao.clearAllCoffeeChats();
 };
 
+/**
+ * Archives all coffee chats by setting the isArchived field to true.
+ * @param user - The user making the request.
+ * @throws PermissionError if the user does not have permissions.
+ */
+export const archiveCoffeeChats = async (user: IdolMember): Promise<void> => {
+  const canArchive = await PermissionsManager.isLeadOrAdmin(user);
+  if (!canArchive) {
+    throw new PermissionError(
+      `User with email ${user.email} does not have permission to archive coffee chats.`
+    );
+  }
+
+  await CoffeeChatDao.archiveCoffeeChats();
+};
+
 /**
  * Gets the coffee chat bingo board
  */

backend/src/api.ts

@@ -43,7 +43,8 @@ import {
   checkMemberMeetsCategory,
   runAutoChecker,
   notifyMemberCoffeeChat,
-  getCoffeeChatSuggestions
+  getCoffeeChatSuggestions,
+  archiveCoffeeChats
 } from './API/coffeeChatAPI';
 import {
   allSignInForms,
@@ -204,6 +205,11 @@ const loginCheckedPut = (
   handler: (req: Request, user: IdolMember) => Promise<Record<string, unknown>>
 ) => router.put(path, loginCheckedHandler(handler));
 
+const loginCheckedPatch = (
+  path: string,
+  handler: (req: Request, user: IdolMember) => Promise<Record<string, unknown>>
+) => router.patch(path, loginCheckedHandler(handler));
+
 // Members
 router.get('/member', async (req, res) => {
   const type = req.query.type as string | undefined;
@@ -341,6 +347,11 @@ loginCheckedPut('/coffee-chat', async (req, user) => ({
   coffeeChat: await updateCoffeeChat(req.body, user)
 }));
 
+loginCheckedPatch('/coffee-chat/archive', async (_, user) => {
+  await archiveCoffeeChats(user);
+  return { message: 'All coffee chats archived successfully.' };
+});
+
 loginCheckedGet('/coffee-chat-bingo-board', async () => {
   const board = await getCoffeeChatBingoBoard();
   return { board };

backend/src/dao/CoffeeChatDao.ts

@@ -137,6 +137,23 @@ export default class CoffeeChatDao extends BaseDao<CoffeeChat, DBCoffeeChat> {
     await deleteCollection(db, 'coffee-chats', 500);
   }
 
+  /**
+   * Archives all coffee chats by setting the isArchived field to true.
+   */
+  static async archiveCoffeeChats(): Promise<void> {
+    const coffeeChatsToDelete = await coffeeChatsCollection.where('isArchived', '==', true).get();
+    const deletePromises = coffeeChatsToDelete.docs.map((doc) => doc.ref.delete());
+
+    const coffeeChatsToArchive = await coffeeChatsCollection.where('isArchived', '==', false).get();
+    const batch = db.batch();
+
+    coffeeChatsToArchive.docs.forEach((doc) => {
+      batch.update(doc.ref, { isArchived: true });
+    });
+
+    await Promise.all([Promise.all(deletePromises), batch.commit()]);
+  }
+
   /**
    * Gets the coffee chat bingo board
    */

frontend/src/API/APIWrapper.ts

@@ -44,6 +44,18 @@ export default class APIWrapper {
       .then((resOrErr) => this.responseMiddleware(resOrErr));
   }
 
+  public static async patch(
+    url: string,
+    body: unknown = {},
+    config = {}
+  ): Promise<APIProcessedResponse> {
+    const idToken = await getUserIDTokenNonNull();
+    return axios
+      .patch(url, body, { headers: { ...config, 'auth-token': idToken } })
+      .catch((err: AxiosError) => err)
+      .then((resOrErr) => this.responseMiddleware(resOrErr));
+  }
+
   private static responseMiddleware(
     resOrErr: AxiosResponse<unknown> | AxiosError
   ): APIProcessedResponse {

frontend/src/API/CoffeeChatAPI.ts

@@ -38,6 +38,17 @@ export default class CoffeeChatAPI {
     await APIWrapper.delete(`${backendURL}/coffee-chat/${uuid}`);
   }
 
+  public static async archiveCoffeeChats(): Promise<void> {
+    return APIWrapper.patch(`${backendURL}/coffee-chat/archive`).then((res) => {
+      if (res.data.error) {
+        Emitters.generalError.emit({
+          headerMsg: "Couldn't archive coffee chats",
+          contentMsg: `Error: ${res.data.error}`
+        });
+      }
+    });
+  }
+
   public static async getCoffeeChatBingoBoard(): Promise<string[][]> {
     const res = await APIWrapper.get(`${backendURL}/coffee-chat-bingo-board`).then(
       (res) => res.data

frontend/src/components/Admin/CoffeeChats/CoffeeChats.tsx

@@ -6,6 +6,7 @@ import styles from './CoffeeChats.module.css';
 import CoffeeChatAPI from '../../../API/CoffeeChatAPI';
 import { useMembers } from '../../Common/FirestoreDataProvider';
 import CoffeeChatsBingoBoard from '../../Forms/CoffeeChatsForm/CoffeeChatsBingoBoard';
+import { Emitters } from '../../../utils';
 
 const CoffeeChats: React.FC = () => {
   const [bingoBoard, setBingoBoard] = useState<string[][]>([[]]);
@@ -62,6 +63,30 @@ const CoffeeChats: React.FC = () => {
     value: member.netid
   }));
 
+  const archiveAllCoffeeChats = async () => {
+    if (
+      !window.confirm(
+        'Are you sure you want to archive all coffee chats? This action cannot be undone.'
+      )
+    ) {
+      return;
+    }
+
+    try {
+      await CoffeeChatAPI.archiveCoffeeChats();
+      Emitters.generalSuccess.emit({
+        headerMsg: 'Success',
+        contentMsg: 'All coffee chats have been archived successfully!! :)'
+      });
+      setIsLoading(true);
+    } catch (error) {
+      Emitters.generalError.emit({
+        headerMsg: 'Error',
+        contentMsg: 'Failed to archive the coffee chats'
+      });
+    }
+  };
+
   return (
     <div className={styles.flexContainer}>
       <div>
@@ -124,6 +149,9 @@ const CoffeeChats: React.FC = () => {
           <Button onClick={() => setSelectedMember(null)} disabled={selectedMember == null}>
             Review All Coffee Chats
           </Button>
+          <Button onClick={archiveAllCoffeeChats} disabled={selectedMember !== null}>
+            Archive All Coffee Chats
+          </Button>
           <div className={styles.dropdownButton}>
             <Dropdown
               placeholder={DEAFAULT_MEMBER_DROPDOWN_TEXT}