@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.1

package/src/admin/calendar/index.ts

@@ -1 +1,2 @@
-export * from "./calendar.admin.service";
+export * from "./calendar.admin.service";
+export * from "./resource-calendar.admin";

package/src/admin/calendar/resource-calendar.admin.ts

@@ -0,0 +1,198 @@
+import * as admin from "firebase-admin";
+import { Appointment } from "../../types/appointment";
+import { CalendarEventStatus } from "../../types/calendar";
+import { Logger } from "../logger";
+import { CLINICS_COLLECTION } from "../../types/clinic";
+import {
+  RESOURCES_COLLECTION,
+  RESOURCE_INSTANCES_SUBCOLLECTION,
+  RESOURCE_CALENDAR_SUBCOLLECTION,
+  ResourceBookingInfo,
+} from "../../types/resource";
+
+/**
+ * @class ResourceCalendarAdminService
+ * @description Handles administrative tasks for resource calendar events linked to appointments,
+ * such as status updates, time changes, or deletions during appointment lifecycle events.
+ */
+export class ResourceCalendarAdminService {
+  private db: admin.firestore.Firestore;
+
+  constructor(firestore?: admin.firestore.Firestore) {
+    this.db = firestore || admin.firestore();
+    Logger.info("[ResourceCalendarAdminService] Initialized.");
+  }
+
+  /**
+   * Builds the Firestore document path for a resource calendar event.
+   */
+  private getResourceCalendarEventPath(
+    clinicBranchId: string,
+    booking: ResourceBookingInfo
+  ): string {
+    return `${CLINICS_COLLECTION}/${clinicBranchId}/${RESOURCES_COLLECTION}/${booking.resourceId}/${RESOURCE_INSTANCES_SUBCOLLECTION}/${booking.resourceInstanceId}/${RESOURCE_CALENDAR_SUBCOLLECTION}/${booking.calendarEventId}`;
+  }
+
+  /**
+   * Updates the status of all resource calendar events associated with a given appointment.
+   *
+   * @param appointment - The appointment object containing resourceBookings.
+   * @param newStatus - The new CalendarEventStatus to set.
+   */
+  async updateResourceBookingEventsStatus(
+    appointment: Appointment,
+    newStatus: CalendarEventStatus
+  ): Promise<void> {
+    const resourceBookings = appointment.resourceBookings;
+    if (!resourceBookings || resourceBookings.length === 0) {
+      Logger.debug(
+        `[ResourceCalendarAdminService] No resource bookings on appointment ${appointment.id}, skipping status update.`
+      );
+      return;
+    }
+
+    Logger.info(
+      `[ResourceCalendarAdminService] Updating ${resourceBookings.length} resource calendar event(s) to ${newStatus} for appointment ${appointment.id}`
+    );
+
+    const batch = this.db.batch();
+    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
+
+    for (const booking of resourceBookings) {
+      const eventPath = this.getResourceCalendarEventPath(
+        appointment.clinicBranchId,
+        booking
+      );
+      const eventRef = this.db.doc(eventPath);
+      batch.update(eventRef, {
+        status: newStatus,
+        updatedAt: serverTimestamp,
+      });
+      Logger.debug(
+        `[ResourceCalendarAdminService] Added status update for resource event ${booking.calendarEventId} (${booking.resourceName} / ${booking.resourceInstanceLabel})`
+      );
+    }
+
+    try {
+      await batch.commit();
+      Logger.info(
+        `[ResourceCalendarAdminService] Successfully updated ${resourceBookings.length} resource calendar event statuses for appointment ${appointment.id}.`
+      );
+    } catch (error) {
+      Logger.error(
+        `[ResourceCalendarAdminService] Error updating resource calendar event statuses for appointment ${appointment.id}:`,
+        error
+      );
+      throw error;
+    }
+  }
+
+  /**
+   * Updates the eventTime (start and end) of all resource calendar events
+   * associated with a given appointment.
+   *
+   * @param appointment - The appointment object containing resourceBookings.
+   * @param newEventTime - The new event time with admin Timestamps.
+   */
+  async updateResourceBookingEventsTime(
+    appointment: Appointment,
+    newEventTime: {
+      start: admin.firestore.Timestamp;
+      end: admin.firestore.Timestamp;
+    }
+  ): Promise<void> {
+    const resourceBookings = appointment.resourceBookings;
+    if (!resourceBookings || resourceBookings.length === 0) {
+      Logger.debug(
+        `[ResourceCalendarAdminService] No resource bookings on appointment ${appointment.id}, skipping time update.`
+      );
+      return;
+    }
+
+    Logger.info(
+      `[ResourceCalendarAdminService] Updating ${resourceBookings.length} resource calendar event time(s) for appointment ${appointment.id}`
+    );
+
+    const batch = this.db.batch();
+    const serverTimestamp = admin.firestore.FieldValue.serverTimestamp();
+
+    for (const booking of resourceBookings) {
+      const eventPath = this.getResourceCalendarEventPath(
+        appointment.clinicBranchId,
+        booking
+      );
+      const eventRef = this.db.doc(eventPath);
+      batch.update(eventRef, {
+        eventTime: {
+          start: newEventTime.start,
+          end: newEventTime.end,
+        },
+        updatedAt: serverTimestamp,
+      });
+      Logger.debug(
+        `[ResourceCalendarAdminService] Added time update for resource event ${booking.calendarEventId} (${booking.resourceName} / ${booking.resourceInstanceLabel})`
+      );
+    }
+
+    try {
+      await batch.commit();
+      Logger.info(
+        `[ResourceCalendarAdminService] Successfully updated ${resourceBookings.length} resource calendar event times for appointment ${appointment.id}.`
+      );
+    } catch (error) {
+      Logger.error(
+        `[ResourceCalendarAdminService] Error updating resource calendar event times for appointment ${appointment.id}:`,
+        error
+      );
+      throw error;
+    }
+  }
+
+  /**
+   * Deletes all resource calendar events associated with a given appointment.
+   *
+   * @param appointment - The appointment object containing resourceBookings.
+   */
+  async deleteResourceBookingEvents(
+    appointment: Appointment
+  ): Promise<void> {
+    const resourceBookings = appointment.resourceBookings;
+    if (!resourceBookings || resourceBookings.length === 0) {
+      Logger.debug(
+        `[ResourceCalendarAdminService] No resource bookings on appointment ${appointment.id}, skipping deletion.`
+      );
+      return;
+    }
+
+    Logger.info(
+      `[ResourceCalendarAdminService] Deleting ${resourceBookings.length} resource calendar event(s) for appointment ${appointment.id}`
+    );
+
+    const batch = this.db.batch();
+
+    for (const booking of resourceBookings) {
+      const eventPath = this.getResourceCalendarEventPath(
+        appointment.clinicBranchId,
+        booking
+      );
+      const eventRef = this.db.doc(eventPath);
+      batch.delete(eventRef);
+      Logger.debug(
+        `[ResourceCalendarAdminService] Added deletion for resource event ${booking.calendarEventId} (${booking.resourceName} / ${booking.resourceInstanceLabel})`
+      );
+    }
+
+    try {
+      await batch.commit();
+      Logger.info(
+        `[ResourceCalendarAdminService] Successfully deleted ${resourceBookings.length} resource calendar events for appointment ${appointment.id}.`
+      );
+    } catch (error) {
+      Logger.error(
+        `[ResourceCalendarAdminService] Error deleting resource calendar events for appointment ${appointment.id}:`,
+        error
+      );
+      throw error;
+    }
+  }
+}