@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

package/src/admin/aggregation/patient/README.md

@@ -1,27 +1,27 @@
-# Patient Aggregation Service (Admin)
-
-This service centralizes the logic for updating aggregated data in various Firestore collections _when patient data is updated or deleted_. It is designed primarily for use by Cloud Functions triggered by changes in the `patients` collection.
-
-**Note:** No specific aggregations are currently defined for patient _creation_ events in this service.
-
-## `PatientAggregationService` Class
-
-### Constructor
-
-```typescript
-constructor(firestore?: admin.firestore.Firestore)
-```
-
-Initializes the service with an Admin Firestore instance. Uses the default instance if none is provided.
-
-### Methods Triggered by Patient **Update**
-
-- **`updatePatientInfoInCalendarEvents(patientId: string, patientInfo: any): Promise<void>`**
-  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `patientId`.
-  - Updates the embedded `patientInfo` object in these calendar events with the provided `patientInfo`.
-
-### Methods Triggered by Patient **Deletion**
-
-- **`cancelUpcomingCalendarEventsForPatient(patientId: string): Promise<void>`**
-  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `patientId`.
-  - Sets the `status` of these events to `CANCELED` and adds a `cancelReason` ("Patient deleted").
+# Patient Aggregation Service (Admin)
+
+This service centralizes the logic for updating aggregated data in various Firestore collections _when patient data is updated or deleted_. It is designed primarily for use by Cloud Functions triggered by changes in the `patients` collection.
+
+**Note:** No specific aggregations are currently defined for patient _creation_ events in this service.
+
+## `PatientAggregationService` Class
+
+### Constructor
+
+```typescript
+constructor(firestore?: admin.firestore.Firestore)
+```
+
+Initializes the service with an Admin Firestore instance. Uses the default instance if none is provided.
+
+### Methods Triggered by Patient **Update**
+
+- **`updatePatientInfoInCalendarEvents(patientId: string, patientInfo: any): Promise<void>`**
+  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `patientId`.
+  - Updates the embedded `patientInfo` object in these calendar events with the provided `patientInfo`.
+
+### Methods Triggered by Patient **Deletion**
+
+- **`cancelUpcomingCalendarEventsForPatient(patientId: string): Promise<void>`**
+  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `patientId`.
+  - Sets the `status` of these events to `CANCELED` and adds a `cancelReason` ("Patient deleted").

package/src/admin/aggregation/patient/index.ts

@@ -1 +1 @@
-export * from "./patient.aggregation.service";
+export * from "./patient.aggregation.service";

package/src/admin/aggregation/patient/patient.aggregation.service.ts

@@ -1,141 +1,141 @@
-import * as admin from "firebase-admin";
-
-const CALENDAR_SUBCOLLECTION_ID = "calendar";
-
-/**
- * @class PatientAggregationService
- * @description Handles aggregation tasks related to patient data updates/deletions.
- */
-export class PatientAggregationService {
-  private db: admin.firestore.Firestore;
-
-  constructor(firestore?: admin.firestore.Firestore) {
-    this.db = firestore || admin.firestore();
-  }
-
-  // --- Methods for Patient Creation --- >
-  // No specific aggregations defined for patient creation in the plan.
-
-  // --- Methods for Patient Update --- >
-  /**
-   * Updates patient information in calendar events
-   * @param patientId - ID of the patient
-   * @param patientInfo - Updated patient information
-   * @returns {Promise<void>}
-   */
-  async updatePatientInfoInCalendarEvents(
-    patientId: string,
-    patientInfo: any
-  ): Promise<void> {
-    if (!patientId || !patientInfo) {
-      console.log(
-        "[PatientAggregationService] Missing patientId or patientInfo for calendar update. Skipping."
-      );
-      return;
-    }
-
-    console.log(
-      `[PatientAggregationService] Querying upcoming calendar events for patient ${patientId} to update patient info.`
-    );
-
-    const now = admin.firestore.Timestamp.now();
-    // Use a Collection Group query
-    const calendarEventsQuery = this.db
-      .collectionGroup(CALENDAR_SUBCOLLECTION_ID)
-      .where("patientId", "==", patientId)
-      .where("eventTime.start", ">", now);
-
-    try {
-      const snapshot = await calendarEventsQuery.get();
-      if (snapshot.empty) {
-        console.log(
-          `[PatientAggregationService] No upcoming calendar events found for patient ${patientId}. No patient info updates needed.`
-        );
-        return;
-      }
-
-      const batch = this.db.batch();
-      snapshot.docs.forEach((doc) => {
-        console.log(
-          `[PatientAggregationService] Updating patient info for calendar event ${doc.ref.path}`
-        );
-        batch.update(doc.ref, {
-          patientInfo: patientInfo,
-          updatedAt: admin.firestore.FieldValue.serverTimestamp(),
-        });
-      });
-
-      await batch.commit();
-      console.log(
-        `[PatientAggregationService] Successfully updated patient info in ${snapshot.size} upcoming calendar events for patient ${patientId}.`
-      );
-    } catch (error) {
-      console.error(
-        `[PatientAggregationService] Error updating patient info in calendar events for patient ${patientId}:`,
-        error
-      );
-      throw error;
-    }
-  }
-
-  // --- Methods for Patient Deletion --- >
-  /**
-   * Cancels all upcoming calendar events associated with a deleted patient
-   * @param patientId - ID of the deleted patient
-   * @returns {Promise<void>}
-   */
-  async cancelUpcomingCalendarEventsForPatient(
-    patientId: string
-  ): Promise<void> {
-    if (!patientId) {
-      console.log(
-        "[PatientAggregationService] Missing patientId for canceling calendar events. Skipping."
-      );
-      return;
-    }
-
-    console.log(
-      `[PatientAggregationService] Querying upcoming calendar events for patient ${patientId} to cancel.`
-    );
-
-    const now = admin.firestore.Timestamp.now();
-    // Use a Collection Group query
-    const calendarEventsQuery = this.db
-      .collectionGroup(CALENDAR_SUBCOLLECTION_ID)
-      .where("patientId", "==", patientId)
-      .where("eventTime.start", ">", now);
-
-    try {
-      const snapshot = await calendarEventsQuery.get();
-      if (snapshot.empty) {
-        console.log(
-          `[PatientAggregationService] No upcoming calendar events found for patient ${patientId}. No events to cancel.`
-        );
-        return;
-      }
-
-      const batch = this.db.batch();
-      snapshot.docs.forEach((doc) => {
-        console.log(
-          `[PatientAggregationService] Canceling calendar event ${doc.ref.path}`
-        );
-        batch.update(doc.ref, {
-          status: "CANCELED",
-          cancelReason: "Patient deleted",
-          updatedAt: admin.firestore.FieldValue.serverTimestamp(),
-        });
-      });
-
-      await batch.commit();
-      console.log(
-        `[PatientAggregationService] Successfully canceled ${snapshot.size} upcoming calendar events for patient ${patientId}.`
-      );
-    } catch (error) {
-      console.error(
-        `[PatientAggregationService] Error canceling calendar events for patient ${patientId}:`,
-        error
-      );
-      throw error;
-    }
-  }
-}
+import * as admin from "firebase-admin";
+
+const CALENDAR_SUBCOLLECTION_ID = "calendar";
+
+/**
+ * @class PatientAggregationService
+ * @description Handles aggregation tasks related to patient data updates/deletions.
+ */
+export class PatientAggregationService {
+  private db: admin.firestore.Firestore;
+
+  constructor(firestore?: admin.firestore.Firestore) {
+    this.db = firestore || admin.firestore();
+  }
+
+  // --- Methods for Patient Creation --- >
+  // No specific aggregations defined for patient creation in the plan.
+
+  // --- Methods for Patient Update --- >
+  /**
+   * Updates patient information in calendar events
+   * @param patientId - ID of the patient
+   * @param patientInfo - Updated patient information
+   * @returns {Promise<void>}
+   */
+  async updatePatientInfoInCalendarEvents(
+    patientId: string,
+    patientInfo: any
+  ): Promise<void> {
+    if (!patientId || !patientInfo) {
+      console.log(
+        "[PatientAggregationService] Missing patientId or patientInfo for calendar update. Skipping."
+      );
+      return;
+    }
+
+    console.log(
+      `[PatientAggregationService] Querying upcoming calendar events for patient ${patientId} to update patient info.`
+    );
+
+    const now = admin.firestore.Timestamp.now();
+    // Use a Collection Group query
+    const calendarEventsQuery = this.db
+      .collectionGroup(CALENDAR_SUBCOLLECTION_ID)
+      .where("patientId", "==", patientId)
+      .where("eventTime.start", ">", now);
+
+    try {
+      const snapshot = await calendarEventsQuery.get();
+      if (snapshot.empty) {
+        console.log(
+          `[PatientAggregationService] No upcoming calendar events found for patient ${patientId}. No patient info updates needed.`
+        );
+        return;
+      }
+
+      const batch = this.db.batch();
+      snapshot.docs.forEach((doc) => {
+        console.log(
+          `[PatientAggregationService] Updating patient info for calendar event ${doc.ref.path}`
+        );
+        batch.update(doc.ref, {
+          patientInfo: patientInfo,
+          updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+        });
+      });
+
+      await batch.commit();
+      console.log(
+        `[PatientAggregationService] Successfully updated patient info in ${snapshot.size} upcoming calendar events for patient ${patientId}.`
+      );
+    } catch (error) {
+      console.error(
+        `[PatientAggregationService] Error updating patient info in calendar events for patient ${patientId}:`,
+        error
+      );
+      throw error;
+    }
+  }
+
+  // --- Methods for Patient Deletion --- >
+  /**
+   * Cancels all upcoming calendar events associated with a deleted patient
+   * @param patientId - ID of the deleted patient
+   * @returns {Promise<void>}
+   */
+  async cancelUpcomingCalendarEventsForPatient(
+    patientId: string
+  ): Promise<void> {
+    if (!patientId) {
+      console.log(
+        "[PatientAggregationService] Missing patientId for canceling calendar events. Skipping."
+      );
+      return;
+    }
+
+    console.log(
+      `[PatientAggregationService] Querying upcoming calendar events for patient ${patientId} to cancel.`
+    );
+
+    const now = admin.firestore.Timestamp.now();
+    // Use a Collection Group query
+    const calendarEventsQuery = this.db
+      .collectionGroup(CALENDAR_SUBCOLLECTION_ID)
+      .where("patientId", "==", patientId)
+      .where("eventTime.start", ">", now);
+
+    try {
+      const snapshot = await calendarEventsQuery.get();
+      if (snapshot.empty) {
+        console.log(
+          `[PatientAggregationService] No upcoming calendar events found for patient ${patientId}. No events to cancel.`
+        );
+        return;
+      }
+
+      const batch = this.db.batch();
+      snapshot.docs.forEach((doc) => {
+        console.log(
+          `[PatientAggregationService] Canceling calendar event ${doc.ref.path}`
+        );
+        batch.update(doc.ref, {
+          status: "CANCELED",
+          cancelReason: "Patient deleted",
+          updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+        });
+      });
+
+      await batch.commit();
+      console.log(
+        `[PatientAggregationService] Successfully canceled ${snapshot.size} upcoming calendar events for patient ${patientId}.`
+      );
+    } catch (error) {
+      console.error(
+        `[PatientAggregationService] Error canceling calendar events for patient ${patientId}:`,
+        error
+      );
+      throw error;
+    }
+  }
+}

package/src/admin/aggregation/practitioner/README.md

@@ -1,42 +1,42 @@
-# Practitioner Aggregation Service (Admin)
-
-This service centralizes the logic for updating aggregated data in various Firestore collections _when a practitioner is created, updated, or deleted_. It is designed primarily for use by Cloud Functions triggered by changes in the `practitioners` collection.
-
-## `PractitionerAggregationService` Class
-
-### Constructor
-
-```typescript
-constructor(firestore?: admin.firestore.Firestore)
-```
-
-Initializes the service with an Admin Firestore instance. Uses the default instance if none is provided.
-
-### Methods Triggered by Practitioner **Creation**
-
-- **`addPractitionerToClinic(clinicId: string, doctorInfo: DoctorInfo): Promise<void>`**
-  - Adds the `practitionerId` (from `doctorInfo.id`) and the `doctorInfo` object to the `doctors` and `doctorsInfo` arrays respectively in the specified `Clinic` document.
-  - Typically called for each clinic the new practitioner is associated with.
-
-### Methods Triggered by Practitioner **Update**
-
-- **`updatePractitionerInfoInClinics(clinicIds: string[], doctorInfo: DoctorInfo): Promise<void>`**
-  - Updates the aggregated `doctorsInfo` array within multiple `Clinic` documents associated with the practitioner.
-  - Uses a batch write to first remove the old `DoctorInfo` (matching by `id`) and then add the updated `doctorInfo`.
-- **`updatePractitionerInfoInProcedures(procedureIds: string[], doctorInfo: DoctorInfo): Promise<void>`**
-  - Updates the embedded `doctorInfo` object within multiple `Procedure` documents associated with the updated practitioner.
-- **`updatePractitionerInfoInCalendarEvents(practitionerId: string, practitionerInfo: DoctorInfo): Promise<void>`**
-  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `practitionerId`.
-  - Updates the embedded `practitionerInfo` object in these calendar events.
-
-### Methods Triggered by Practitioner **Deletion**
-
-- **`removePractitionerFromClinics(clinicIds: string[], practitionerId: string): Promise<void>`**
-  - Removes the `practitionerId` from the `doctors` array and the corresponding `DoctorInfo` object (matching by `id`) from the `doctorsInfo` array in multiple `Clinic` documents.
-- **`cancelUpcomingCalendarEventsForPractitioner(practitionerId: string): Promise<void>`**
-  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `practitionerId`.
-  - Sets the `status` of these events to `CANCELED` and adds a `cancelReason` ("Practitioner deleted").
-- **`removePractitionerFromPatients(patientIds: string[], practitionerId: string): Promise<void>`**
-  - Removes the `practitionerId` from the `doctorIds` array in multiple `Patient` documents.
-- **`inactivateProceduresForPractitioner(procedureIds: string[]): Promise<void>`**
-  - Sets the `isActive` flag to `false` for multiple `Procedure` documents associated with the deleted practitioner.
+# Practitioner Aggregation Service (Admin)
+
+This service centralizes the logic for updating aggregated data in various Firestore collections _when a practitioner is created, updated, or deleted_. It is designed primarily for use by Cloud Functions triggered by changes in the `practitioners` collection.
+
+## `PractitionerAggregationService` Class
+
+### Constructor
+
+```typescript
+constructor(firestore?: admin.firestore.Firestore)
+```
+
+Initializes the service with an Admin Firestore instance. Uses the default instance if none is provided.
+
+### Methods Triggered by Practitioner **Creation**
+
+- **`addPractitionerToClinic(clinicId: string, doctorInfo: DoctorInfo): Promise<void>`**
+  - Adds the `practitionerId` (from `doctorInfo.id`) and the `doctorInfo` object to the `doctors` and `doctorsInfo` arrays respectively in the specified `Clinic` document.
+  - Typically called for each clinic the new practitioner is associated with.
+
+### Methods Triggered by Practitioner **Update**
+
+- **`updatePractitionerInfoInClinics(clinicIds: string[], doctorInfo: DoctorInfo): Promise<void>`**
+  - Updates the aggregated `doctorsInfo` array within multiple `Clinic` documents associated with the practitioner.
+  - Uses a batch write to first remove the old `DoctorInfo` (matching by `id`) and then add the updated `doctorInfo`.
+- **`updatePractitionerInfoInProcedures(procedureIds: string[], doctorInfo: DoctorInfo): Promise<void>`**
+  - Updates the embedded `doctorInfo` object within multiple `Procedure` documents associated with the updated practitioner.
+- **`updatePractitionerInfoInCalendarEvents(practitionerId: string, practitionerInfo: DoctorInfo): Promise<void>`**
+  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `practitionerId`.
+  - Updates the embedded `practitionerInfo` object in these calendar events.
+
+### Methods Triggered by Practitioner **Deletion**
+
+- **`removePractitionerFromClinics(clinicIds: string[], practitionerId: string): Promise<void>`**
+  - Removes the `practitionerId` from the `doctors` array and the corresponding `DoctorInfo` object (matching by `id`) from the `doctorsInfo` array in multiple `Clinic` documents.
+- **`cancelUpcomingCalendarEventsForPractitioner(practitionerId: string): Promise<void>`**
+  - Uses a Collection Group query (`calendar` subcollection) to find all _upcoming_ calendar events associated with the `practitionerId`.
+  - Sets the `status` of these events to `CANCELED` and adds a `cancelReason` ("Practitioner deleted").
+- **`removePractitionerFromPatients(patientIds: string[], practitionerId: string): Promise<void>`**
+  - Removes the `practitionerId` from the `doctorIds` array in multiple `Patient` documents.
+- **`inactivateProceduresForPractitioner(procedureIds: string[]): Promise<void>`**
+  - Sets the `isActive` flag to `false` for multiple `Procedure` documents associated with the deleted practitioner.

package/src/admin/aggregation/practitioner/index.ts

@@ -1 +1 @@
-export * from "./practitioner.aggregation.service";
+export * from "./practitioner.aggregation.service";