@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

package/src/admin/calendar/calendar.admin.service.ts

@@ -1,345 +1,345 @@
-import * as admin from "firebase-admin";
-import { Appointment, APPOINTMENTS_COLLECTION } from "../../types/appointment";
-import {
-  CalendarEventStatus,
-  CalendarEventTime,
-  CALENDAR_COLLECTION,
-} from "../../types/calendar";
-import { Timestamp as FirebaseClientTimestamp } from "@firebase/firestore";
-import { Logger } from "../logger";
-import { PRACTITIONERS_COLLECTION } from "../../types/practitioner";
-import { PATIENTS_COLLECTION } from "../../types/patient";
-import { CLINICS_COLLECTION } from "../../types/clinic";
-import { TimestampUtils } from "../../utils/TimestampUtils";
-
-/**
- * @class CalendarAdminService
- * @description Handles administrative tasks for calendar events linked to appointments,
- * such as status updates, time changes, or deletions, subsequent to their initial creation.
- */
-export class CalendarAdminService {
-  private db: admin.firestore.Firestore;
-
-  constructor(firestore?: admin.firestore.Firestore) {
-    this.db = firestore || admin.firestore();
-    Logger.info("[CalendarAdminService] Initialized.");
-  }
-
-  /**
-   * Updates the status of all three calendar events (practitioner, patient, clinic)
-   * associated with a given appointment.
-   *
-   * @param appointment - The appointment object containing references to its calendar events.
-   * @param newStatus - The new CalendarEventStatus to set.
-   * @returns {Promise<void>} A promise that resolves when all updates are attempted.
-   */
-  async updateAppointmentCalendarEventsStatus(
-    appointment: Appointment,
-    newStatus: CalendarEventStatus
-  ): Promise<void> {
-    Logger.info(
-      `[CalendarAdminService] Updating calendar event statuses for appointment ${appointment.id} to ${newStatus}`
-    );
-    const batch = this.db.batch();
-    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
-    let updatesAdded = 0;
-
-    // Get the shared calendar event ID
-    const calendarEventId = appointment.calendarEventId;
-
-    if (!calendarEventId) {
-      Logger.warn(
-        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
-      );
-      return;
-    }
-
-    // Update practitioner calendar event
-    if (appointment.practitionerId) {
-      const practitionerEventRef = this.db.doc(
-        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(practitionerEventRef, {
-        status: newStatus,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added practitioner calendar event status update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Update patient calendar event
-    if (appointment.patientId) {
-      const patientEventRef = this.db.doc(
-        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(patientEventRef, {
-        status: newStatus,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added patient calendar event status update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Update clinic calendar event
-    if (appointment.clinicBranchId) {
-      const clinicEventRef = this.db.doc(
-        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(clinicEventRef, {
-        status: newStatus,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added clinic calendar event status update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Only commit if we have updates to make
-    if (updatesAdded > 0) {
-      try {
-        await batch.commit();
-        Logger.info(
-          `[CalendarAdminService] Successfully updated ${updatesAdded} calendar event statuses for appointment ${appointment.id}.`
-        );
-      } catch (error) {
-        Logger.error(
-          `[CalendarAdminService] Error updating calendar event statuses for appointment ${appointment.id}:`,
-          error
-        );
-        throw error; // Re-throw to allow caller to handle
-      }
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] No calendar event status updates were made for appointment ${appointment.id}`
-      );
-    }
-  }
-
-  /**
-   * Updates the eventTime (start and end) of all three calendar events
-   * associated with a given appointment.
-   *
-   * @param appointment - The appointment object.
-   * @param newEventTime - The new CalendarEventTime object (using admin.firestore.Timestamp).
-   * @returns {Promise<void>} A promise that resolves when all updates are attempted.
-   */
-  async updateAppointmentCalendarEventsTime(
-    appointment: Appointment,
-    newEventTime: {
-      start: admin.firestore.Timestamp;
-      end: admin.firestore.Timestamp;
-    }
-  ): Promise<void> {
-    Logger.info(
-      `[CalendarAdminService] Updating calendar event times for appointment ${appointment.id}`
-    );
-    const batch = this.db.batch();
-    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
-    let updatesAdded = 0;
-
-    // Get the shared calendar event ID
-    const calendarEventId = appointment.calendarEventId;
-
-    if (!calendarEventId) {
-      Logger.warn(
-        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
-      );
-      return;
-    }
-
-    // Use the timestamps directly since they are already admin.firestore.Timestamp
-    const firestoreCompatibleEventTime = {
-      start: newEventTime.start,
-      end: newEventTime.end,
-    };
-
-    // Update practitioner calendar event
-    if (appointment.practitionerId) {
-      const practitionerEventRef = this.db.doc(
-        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(practitionerEventRef, {
-        eventTime: firestoreCompatibleEventTime,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added practitioner calendar event time update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Update patient calendar event
-    if (appointment.patientId) {
-      const patientEventRef = this.db.doc(
-        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(patientEventRef, {
-        eventTime: firestoreCompatibleEventTime,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added patient calendar event time update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Update clinic calendar event
-    if (appointment.clinicBranchId) {
-      const clinicEventRef = this.db.doc(
-        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.update(clinicEventRef, {
-        eventTime: firestoreCompatibleEventTime,
-        updatedAt: serverTimestamp,
-      });
-      updatesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added clinic calendar event time update to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Only commit if we have updates to make
-    if (updatesAdded > 0) {
-      try {
-        await batch.commit();
-        Logger.info(
-          `[CalendarAdminService] Successfully updated ${updatesAdded} calendar event times for appointment ${appointment.id}.`
-        );
-      } catch (error) {
-        Logger.error(
-          `[CalendarAdminService] Error updating calendar event times for appointment ${appointment.id}:`,
-          error
-        );
-        throw error; // Re-throw to allow caller to handle
-      }
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] No calendar event time updates were made for appointment ${appointment.id}`
-      );
-    }
-  }
-
-  /**
-   * Deletes all three calendar events associated with a given appointment.
-   * Note: This is a hard delete. Consider marking as CANCELLED instead if soft delete is preferred.
-   *
-   * @param appointment - The appointment object.
-   * @returns {Promise<void>} A promise that resolves when all deletions are attempted.
-   */
-  async deleteAppointmentCalendarEvents(
-    appointment: Appointment
-  ): Promise<void> {
-    Logger.info(
-      `[CalendarAdminService] Deleting calendar events for appointment ${appointment.id}`
-    );
-    const batch = this.db.batch();
-    let deletesAdded = 0;
-
-    // Get the shared calendar event ID
-    const calendarEventId = appointment.calendarEventId;
-
-    if (!calendarEventId) {
-      Logger.warn(
-        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
-      );
-      return;
-    }
-
-    // Delete practitioner calendar event
-    if (appointment.practitionerId) {
-      const practitionerEventRef = this.db.doc(
-        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.delete(practitionerEventRef);
-      deletesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added practitioner calendar event deletion to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Delete patient calendar event
-    if (appointment.patientId) {
-      const patientEventRef = this.db.doc(
-        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.delete(patientEventRef);
-      deletesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added patient calendar event deletion to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Delete clinic calendar event
-    if (appointment.clinicBranchId) {
-      const clinicEventRef = this.db.doc(
-        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
-      );
-      batch.delete(clinicEventRef);
-      deletesAdded++;
-      Logger.debug(
-        `[CalendarAdminService] Added clinic calendar event deletion to batch`
-      );
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
-      );
-    }
-
-    // Only commit if we have deletions to make
-    if (deletesAdded > 0) {
-      try {
-        await batch.commit();
-        Logger.info(
-          `[CalendarAdminService] Successfully deleted ${deletesAdded} calendar events for appointment ${appointment.id}.`
-        );
-      } catch (error) {
-        Logger.error(
-          `[CalendarAdminService] Error deleting calendar events for appointment ${appointment.id}:`,
-          error
-        );
-        throw error; // Re-throw to allow caller to handle
-      }
-    } else {
-      Logger.warn(
-        `[CalendarAdminService] No calendar event deletions were made for appointment ${appointment.id}`
-      );
-    }
-  }
-}
+import * as admin from "firebase-admin";
+import { Appointment, APPOINTMENTS_COLLECTION } from "../../types/appointment";
+import {
+  CalendarEventStatus,
+  CalendarEventTime,
+  CALENDAR_COLLECTION,
+} from "../../types/calendar";
+import { Timestamp as FirebaseClientTimestamp } from "@firebase/firestore";
+import { Logger } from "../logger";
+import { PRACTITIONERS_COLLECTION } from "../../types/practitioner";
+import { PATIENTS_COLLECTION } from "../../types/patient";
+import { CLINICS_COLLECTION } from "../../types/clinic";
+import { TimestampUtils } from "../../utils/TimestampUtils";
+
+/**
+ * @class CalendarAdminService
+ * @description Handles administrative tasks for calendar events linked to appointments,
+ * such as status updates, time changes, or deletions, subsequent to their initial creation.
+ */
+export class CalendarAdminService {
+  private db: admin.firestore.Firestore;
+
+  constructor(firestore?: admin.firestore.Firestore) {
+    this.db = firestore || admin.firestore();
+    Logger.info("[CalendarAdminService] Initialized.");
+  }
+
+  /**
+   * Updates the status of all three calendar events (practitioner, patient, clinic)
+   * associated with a given appointment.
+   *
+   * @param appointment - The appointment object containing references to its calendar events.
+   * @param newStatus - The new CalendarEventStatus to set.
+   * @returns {Promise<void>} A promise that resolves when all updates are attempted.
+   */
+  async updateAppointmentCalendarEventsStatus(
+    appointment: Appointment,
+    newStatus: CalendarEventStatus
+  ): Promise<void> {
+    Logger.info(
+      `[CalendarAdminService] Updating calendar event statuses for appointment ${appointment.id} to ${newStatus}`
+    );
+    const batch = this.db.batch();
+    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
+    let updatesAdded = 0;
+
+    // Get the shared calendar event ID
+    const calendarEventId = appointment.calendarEventId;
+
+    if (!calendarEventId) {
+      Logger.warn(
+        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
+      );
+      return;
+    }
+
+    // Update practitioner calendar event
+    if (appointment.practitionerId) {
+      const practitionerEventRef = this.db.doc(
+        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(practitionerEventRef, {
+        status: newStatus,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added practitioner calendar event status update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Update patient calendar event
+    if (appointment.patientId) {
+      const patientEventRef = this.db.doc(
+        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(patientEventRef, {
+        status: newStatus,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added patient calendar event status update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Update clinic calendar event
+    if (appointment.clinicBranchId) {
+      const clinicEventRef = this.db.doc(
+        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(clinicEventRef, {
+        status: newStatus,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added clinic calendar event status update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Only commit if we have updates to make
+    if (updatesAdded > 0) {
+      try {
+        await batch.commit();
+        Logger.info(
+          `[CalendarAdminService] Successfully updated ${updatesAdded} calendar event statuses for appointment ${appointment.id}.`
+        );
+      } catch (error) {
+        Logger.error(
+          `[CalendarAdminService] Error updating calendar event statuses for appointment ${appointment.id}:`,
+          error
+        );
+        throw error; // Re-throw to allow caller to handle
+      }
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] No calendar event status updates were made for appointment ${appointment.id}`
+      );
+    }
+  }
+
+  /**
+   * Updates the eventTime (start and end) of all three calendar events
+   * associated with a given appointment.
+   *
+   * @param appointment - The appointment object.
+   * @param newEventTime - The new CalendarEventTime object (using admin.firestore.Timestamp).
+   * @returns {Promise<void>} A promise that resolves when all updates are attempted.
+   */
+  async updateAppointmentCalendarEventsTime(
+    appointment: Appointment,
+    newEventTime: {
+      start: admin.firestore.Timestamp;
+      end: admin.firestore.Timestamp;
+    }
+  ): Promise<void> {
+    Logger.info(
+      `[CalendarAdminService] Updating calendar event times for appointment ${appointment.id}`
+    );
+    const batch = this.db.batch();
+    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
+    let updatesAdded = 0;
+
+    // Get the shared calendar event ID
+    const calendarEventId = appointment.calendarEventId;
+
+    if (!calendarEventId) {
+      Logger.warn(
+        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
+      );
+      return;
+    }
+
+    // Use the timestamps directly since they are already admin.firestore.Timestamp
+    const firestoreCompatibleEventTime = {
+      start: newEventTime.start,
+      end: newEventTime.end,
+    };
+
+    // Update practitioner calendar event
+    if (appointment.practitionerId) {
+      const practitionerEventRef = this.db.doc(
+        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(practitionerEventRef, {
+        eventTime: firestoreCompatibleEventTime,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added practitioner calendar event time update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Update patient calendar event
+    if (appointment.patientId) {
+      const patientEventRef = this.db.doc(
+        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(patientEventRef, {
+        eventTime: firestoreCompatibleEventTime,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added patient calendar event time update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Update clinic calendar event
+    if (appointment.clinicBranchId) {
+      const clinicEventRef = this.db.doc(
+        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.update(clinicEventRef, {
+        eventTime: firestoreCompatibleEventTime,
+        updatedAt: serverTimestamp,
+      });
+      updatesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added clinic calendar event time update to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Only commit if we have updates to make
+    if (updatesAdded > 0) {
+      try {
+        await batch.commit();
+        Logger.info(
+          `[CalendarAdminService] Successfully updated ${updatesAdded} calendar event times for appointment ${appointment.id}.`
+        );
+      } catch (error) {
+        Logger.error(
+          `[CalendarAdminService] Error updating calendar event times for appointment ${appointment.id}:`,
+          error
+        );
+        throw error; // Re-throw to allow caller to handle
+      }
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] No calendar event time updates were made for appointment ${appointment.id}`
+      );
+    }
+  }
+
+  /**
+   * Deletes all three calendar events associated with a given appointment.
+   * Note: This is a hard delete. Consider marking as CANCELLED instead if soft delete is preferred.
+   *
+   * @param appointment - The appointment object.
+   * @returns {Promise<void>} A promise that resolves when all deletions are attempted.
+   */
+  async deleteAppointmentCalendarEvents(
+    appointment: Appointment
+  ): Promise<void> {
+    Logger.info(
+      `[CalendarAdminService] Deleting calendar events for appointment ${appointment.id}`
+    );
+    const batch = this.db.batch();
+    let deletesAdded = 0;
+
+    // Get the shared calendar event ID
+    const calendarEventId = appointment.calendarEventId;
+
+    if (!calendarEventId) {
+      Logger.warn(
+        `[CalendarAdminService] Missing calendar event ID for appointment ${appointment.id}`
+      );
+      return;
+    }
+
+    // Delete practitioner calendar event
+    if (appointment.practitionerId) {
+      const practitionerEventRef = this.db.doc(
+        `${PRACTITIONERS_COLLECTION}/${appointment.practitionerId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.delete(practitionerEventRef);
+      deletesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added practitioner calendar event deletion to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing practitioner ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Delete patient calendar event
+    if (appointment.patientId) {
+      const patientEventRef = this.db.doc(
+        `${PATIENTS_COLLECTION}/${appointment.patientId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.delete(patientEventRef);
+      deletesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added patient calendar event deletion to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing patient ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Delete clinic calendar event
+    if (appointment.clinicBranchId) {
+      const clinicEventRef = this.db.doc(
+        `${CLINICS_COLLECTION}/${appointment.clinicBranchId}/${CALENDAR_COLLECTION}/${calendarEventId}`
+      );
+      batch.delete(clinicEventRef);
+      deletesAdded++;
+      Logger.debug(
+        `[CalendarAdminService] Added clinic calendar event deletion to batch`
+      );
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] Missing clinic ID for appointment ${appointment.id}`
+      );
+    }
+
+    // Only commit if we have deletions to make
+    if (deletesAdded > 0) {
+      try {
+        await batch.commit();
+        Logger.info(
+          `[CalendarAdminService] Successfully deleted ${deletesAdded} calendar events for appointment ${appointment.id}.`
+        );
+      } catch (error) {
+        Logger.error(
+          `[CalendarAdminService] Error deleting calendar events for appointment ${appointment.id}:`,
+          error
+        );
+        throw error; // Re-throw to allow caller to handle
+      }
+    } else {
+      Logger.warn(
+        `[CalendarAdminService] No calendar event deletions were made for appointment ${appointment.id}`
+      );
+    }
+  }
+}