@blackcode_sa/metaestetics-api 1.13.4 → 1.13.5

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

@@ -1,265 +1,265 @@
-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,
-  });
-}
+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,
+  });
+}