@blackcode_sa/metaestetics-api 1.4.17 → 1.5.0

package/src/services/calendar/utils/appointment.utils.ts

@@ -0,0 +1,314 @@
+import { Firestore, Timestamp } from "firebase/firestore";
+import {
+  CalendarEvent,
+  CalendarEventStatus,
+  CalendarEventTime,
+  CalendarEventType,
+  CalendarSyncStatus,
+  CreateCalendarEventData,
+  UpdateCalendarEventData,
+} from "../../../types/calendar";
+import {
+  createClinicCalendarEventUtil,
+  updateClinicCalendarEventUtil,
+  deleteClinicCalendarEventUtil,
+  checkAutoConfirmAppointmentsUtil,
+} from "./clinic.utils";
+import {
+  createPatientCalendarEventUtil,
+  updatePatientCalendarEventUtil,
+  deletePatientCalendarEventUtil,
+} from "./patient.utils";
+import {
+  createPractitionerCalendarEventUtil,
+  updatePractitionerCalendarEventUtil,
+  deletePractitionerCalendarEventUtil,
+} from "./practitioner.utils";
+
+/**
+ * Creates an appointment across all relevant calendars (practitioner, patient, clinic)
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventData - Calendar event data
+ * @param generateId - Function to generate a unique ID
+ * @returns Created calendar event
+ */
+export async function createAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventData: Omit<
+    CreateCalendarEventData,
+    | "id"
+    | "createdAt"
+    | "updatedAt"
+    | "clinicBranchId"
+    | "practitionerProfileId"
+    | "patientProfileId"
+  >,
+  generateId: () => string
+): Promise<CalendarEvent> {
+  // TODO: Add validation for appointment data
+  // - Check if all entities exist
+  // - Validate event time (start < end)
+  // - Check for overlapping events
+  // - Validate required fields
+
+  // Generate a single ID to be used across all calendars
+  const eventId = generateId();
+
+  // Check if the clinic has auto-confirm appointments enabled
+  const autoConfirm = await checkAutoConfirmAppointmentsUtil(db, clinicId);
+
+  // Set the initial status based on auto-confirm setting
+  const initialStatus = autoConfirm
+    ? CalendarEventStatus.CONFIRMED
+    : CalendarEventStatus.PENDING;
+
+  // Prepare the event data with all required IDs
+  const appointmentData: Omit<
+    CreateCalendarEventData,
+    "id" | "createdAt" | "updatedAt"
+  > = {
+    ...eventData,
+    clinicBranchId: clinicId,
+    practitionerProfileId: practitionerId,
+    patientProfileId: patientId,
+    eventType: CalendarEventType.APPOINTMENT,
+    status: eventData.status || initialStatus,
+  };
+
+  // Create the event in all three calendars
+  const clinicPromise = createClinicCalendarEventUtil(
+    db,
+    clinicId,
+    appointmentData,
+    () => eventId // Use the same ID for all calendars
+  );
+
+  const practitionerPromise = createPractitionerCalendarEventUtil(
+    db,
+    practitionerId,
+    appointmentData,
+    () => eventId // Use the same ID for all calendars
+  );
+
+  const patientPromise = createPatientCalendarEventUtil(
+    db,
+    patientId,
+    appointmentData,
+    () => eventId // Use the same ID for all calendars
+  );
+
+  // Wait for all operations to complete
+  const [clinicEvent] = await Promise.all([
+    clinicPromise,
+    practitionerPromise,
+    patientPromise,
+  ]);
+
+  // Return the event from the clinic calendar
+  return clinicEvent;
+}
+
+/**
+ * Updates an appointment across all relevant calendars (practitioner, patient, clinic)
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @param updateData - Data to update
+ * @returns Updated calendar event
+ */
+export async function updateAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string,
+  updateData: Omit<UpdateCalendarEventData, "updatedAt">
+): Promise<CalendarEvent> {
+  // TODO: Add validation for update data
+  // - Check if event exists in all calendars
+  // - Validate event time (start < end)
+  // - Check for overlapping events
+
+  // Update the event in all three calendars
+  const clinicPromise = updateClinicCalendarEventUtil(
+    db,
+    clinicId,
+    eventId,
+    updateData
+  );
+
+  const practitionerPromise = updatePractitionerCalendarEventUtil(
+    db,
+    practitionerId,
+    eventId,
+    updateData
+  );
+
+  const patientPromise = updatePatientCalendarEventUtil(
+    db,
+    patientId,
+    eventId,
+    updateData
+  );
+
+  // Wait for all operations to complete
+  const [clinicEvent] = await Promise.all([
+    clinicPromise,
+    practitionerPromise,
+    patientPromise,
+  ]);
+
+  // Return the event from the clinic calendar
+  return clinicEvent;
+}
+
+/**
+ * Deletes an appointment across all relevant calendars (practitioner, patient, clinic)
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ */
+export async function deleteAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string
+): Promise<void> {
+  // Delete the event from all three calendars
+  const clinicPromise = deleteClinicCalendarEventUtil(db, clinicId, eventId);
+
+  const practitionerPromise = deletePractitionerCalendarEventUtil(
+    db,
+    practitionerId,
+    eventId
+  );
+
+  const patientPromise = deletePatientCalendarEventUtil(db, patientId, eventId);
+
+  // Wait for all operations to complete
+  await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
+}
+
+/**
+ * Confirms an appointment
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @returns Confirmed calendar event
+ */
+export async function confirmAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string
+): Promise<CalendarEvent> {
+  return updateAppointmentUtil(
+    db,
+    clinicId,
+    practitionerId,
+    patientId,
+    eventId,
+    { status: CalendarEventStatus.CONFIRMED }
+  );
+}
+
+/**
+ * Rejects an appointment
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @returns Rejected calendar event
+ */
+export async function rejectAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string
+): Promise<CalendarEvent> {
+  return updateAppointmentUtil(
+    db,
+    clinicId,
+    practitionerId,
+    patientId,
+    eventId,
+    { status: CalendarEventStatus.REJECTED }
+  );
+}
+
+/**
+ * Cancels an appointment
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @returns Canceled calendar event
+ */
+export async function cancelAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string
+): Promise<CalendarEvent> {
+  return updateAppointmentUtil(
+    db,
+    clinicId,
+    practitionerId,
+    patientId,
+    eventId,
+    { status: CalendarEventStatus.CANCELED }
+  );
+}
+
+/**
+ * Reschedules an appointment
+ * @param db - Firestore instance
+ * @param clinicId - ID of the clinic
+ * @param practitionerId - ID of the practitioner
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @param newEventTime - New event time
+ * @returns Rescheduled calendar event
+ */
+export async function rescheduleAppointmentUtil(
+  db: Firestore,
+  clinicId: string,
+  practitionerId: string,
+  patientId: string,
+  eventId: string,
+  newEventTime: CalendarEventTime
+): Promise<CalendarEvent> {
+  // TODO: Add validation for new event time
+  // - Validate event time (start < end)
+  // - Check for overlapping events
+
+  return updateAppointmentUtil(
+    db,
+    clinicId,
+    practitionerId,
+    patientId,
+    eventId,
+    {
+      status: CalendarEventStatus.RESCHEDULED,
+      eventTime: newEventTime,
+    }
+  );
+}