@blackcode_sa/metaestetics-api 1.12.33 → 1.12.35

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.12.33",
+  "version": "1.12.35",
   "description": "Firebase authentication service with anonymous upgrade support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

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

@@ -15,7 +15,7 @@ import {
   startAfter,
   QueryConstraint,
   DocumentSnapshot,
-} from "firebase/firestore";
+} from 'firebase/firestore';
 import {
   Appointment,
   AppointmentStatus,
@@ -24,25 +24,18 @@ import {
   APPOINTMENTS_COLLECTION,
   SearchAppointmentsParams,
   PaymentStatus,
-} from "../../../types/appointment";
-import { CalendarEvent, CALENDAR_COLLECTION } from "../../../types/calendar";
-import { ProcedureSummaryInfo } from "../../../types/procedure";
-import {
-  ClinicInfo,
-  PatientProfileInfo,
-  PractitionerProfileInfo,
-} from "../../../types/profile";
-import { BlockingCondition } from "../../../backoffice/types/static/blocking-condition.types";
-import { Requirement } from "../../../backoffice/types/requirement.types";
-import { PRACTITIONERS_COLLECTION } from "../../../types/practitioner";
-import { CLINICS_COLLECTION } from "../../../types/clinic";
-import { PATIENTS_COLLECTION } from "../../../types/patient";
-import { PROCEDURES_COLLECTION } from "../../../types/procedure";
-import {
-  Technology,
-  TECHNOLOGIES_COLLECTION,
-} from "../../../backoffice/types/technology.types";
-import type { ContraindicationDynamic } from "../../../backoffice";
+} from '../../../types/appointment';
+import { CalendarEvent, CALENDAR_COLLECTION } from '../../../types/calendar';
+import { ProcedureSummaryInfo } from '../../../types/procedure';
+import { ClinicInfo, PatientProfileInfo, PractitionerProfileInfo } from '../../../types/profile';
+import { BlockingCondition } from '../../../backoffice/types/static/blocking-condition.types';
+import { Requirement } from '../../../backoffice/types/requirement.types';
+import { PRACTITIONERS_COLLECTION } from '../../../types/practitioner';
+import { CLINICS_COLLECTION } from '../../../types/clinic';
+import { PATIENTS_COLLECTION } from '../../../types/patient';
+import { PROCEDURES_COLLECTION } from '../../../types/procedure';
+import { Technology, TECHNOLOGIES_COLLECTION } from '../../../backoffice/types/technology.types';
+import type { ContraindicationDynamic } from '../../../backoffice';
 
 /**
  * Fetches all the necessary information for an appointment by IDs.
@@ -59,7 +52,7 @@ export async function fetchAggregatedInfoUtil(
   clinicId: string,
   practitionerId: string,
   patientId: string,
-  procedureId: string
+  procedureId: string,
 ): Promise<{
   clinicInfo: ClinicInfo;
   practitionerInfo: PractitionerProfileInfo;
@@ -72,13 +65,12 @@ export async function fetchAggregatedInfoUtil(
 }> {
   try {
     // Fetch all data in parallel for efficiency
-    const [clinicDoc, practitionerDoc, patientDoc, procedureDoc] =
-      await Promise.all([
-        getDoc(doc(db, CLINICS_COLLECTION, clinicId)),
-        getDoc(doc(db, PRACTITIONERS_COLLECTION, practitionerId)),
-        getDoc(doc(db, PATIENTS_COLLECTION, patientId)),
-        getDoc(doc(db, PROCEDURES_COLLECTION, procedureId)),
-      ]);
+    const [clinicDoc, practitionerDoc, patientDoc, procedureDoc] = await Promise.all([
+      getDoc(doc(db, CLINICS_COLLECTION, clinicId)),
+      getDoc(doc(db, PRACTITIONERS_COLLECTION, practitionerId)),
+      getDoc(doc(db, PATIENTS_COLLECTION, patientId)),
+      getDoc(doc(db, PROCEDURES_COLLECTION, procedureId)),
+    ]);
 
     // Check if all required entities exist
     if (!clinicDoc.exists()) {
@@ -102,7 +94,7 @@ export async function fetchAggregatedInfoUtil(
     // Extract relevant info for ClinicInfo
     const clinicInfo: ClinicInfo = {
       id: clinicId,
-      featuredPhoto: clinicData.featuredPhotos?.[0] || "",
+      featuredPhoto: clinicData.featuredPhotos?.[0] || '',
       name: clinicData.name,
       description: clinicData.description || null,
       location: clinicData.location,
@@ -113,10 +105,10 @@ export async function fetchAggregatedInfoUtil(
     const practitionerInfo: PractitionerProfileInfo = {
       id: practitionerId,
       practitionerPhoto: practitionerData.basicInfo?.profileImageUrl || null,
-      name: `${practitionerData.basicInfo?.firstName || ""} ${
-        practitionerData.basicInfo?.lastName || ""
+      name: `${practitionerData.basicInfo?.firstName || ''} ${
+        practitionerData.basicInfo?.lastName || ''
       }`.trim(),
-      email: practitionerData.basicInfo?.email || "",
+      email: practitionerData.basicInfo?.email || '',
       phone: practitionerData.basicInfo?.phoneNumber || null,
       certification: practitionerData.certification,
     };
@@ -125,11 +117,11 @@ export async function fetchAggregatedInfoUtil(
     // Note: This may need adjustment depending on how patient data is structured
     const patientInfo: PatientProfileInfo = {
       id: patientId,
-      fullName: patientData.displayName || "",
-      email: patientData.email || "",
+      fullName: patientData.displayName || '',
+      email: patientData.email || '',
       phone: patientData.phoneNumber || null,
       dateOfBirth: patientData.dateOfBirth || Timestamp.now(),
-      gender: patientData.gender || "other",
+      gender: patientData.gender || 'other',
     };
 
     // Extract procedureInfo from the procedure document
@@ -138,13 +130,13 @@ export async function fetchAggregatedInfoUtil(
       id: procedureId,
       name: procedureData.name,
       description: procedureData.description,
-      photo: procedureData.photo || "",
+      photo: procedureData.photo || '',
       family: procedureData.family,
-      categoryName: procedureData.category?.name || "",
-      subcategoryName: procedureData.subcategory?.name || "",
-      technologyName: procedureData.technology?.name || "",
-      brandName: procedureData.product?.brand || "",
-      productName: procedureData.product?.name || "",
+      categoryName: procedureData.category?.name || '',
+      subcategoryName: procedureData.subcategory?.name || '',
+      technologyName: procedureData.technology?.name || '',
+      brandName: procedureData.product?.brand || '',
+      productName: procedureData.product?.name || '',
       price: procedureData.price || 0,
       pricingMeasure: procedureData.pricingMeasure,
       currency: procedureData.currency,
@@ -156,7 +148,7 @@ export async function fetchAggregatedInfoUtil(
     };
 
     // Fetch the technology document to get procedure requirements
-    let technologyId = "";
+    let technologyId = '';
     if (procedureData.technology?.id) {
       technologyId = procedureData.technology.id;
     }
@@ -168,9 +160,7 @@ export async function fetchAggregatedInfoUtil(
 
     // If we have a technology ID, fetch its details
     if (technologyId) {
-      const technologyDoc = await getDoc(
-        doc(db, TECHNOLOGIES_COLLECTION, technologyId)
-      );
+      const technologyDoc = await getDoc(doc(db, TECHNOLOGIES_COLLECTION, technologyId));
       if (technologyDoc.exists()) {
         const technologyData = technologyDoc.data() as Technology;
 
@@ -199,7 +189,7 @@ export async function fetchAggregatedInfoUtil(
       postProcedureRequirements,
     };
   } catch (error) {
-    console.error("Error fetching aggregated info:", error);
+    console.error('Error fetching aggregated info:', error);
     throw error;
   }
 }
@@ -304,7 +294,7 @@ export async function fetchAggregatedInfoUtil(
 export async function updateAppointmentUtil(
   db: Firestore,
   appointmentId: string,
-  data: UpdateAppointmentData
+  data: UpdateAppointmentData,
 ): Promise<Appointment> {
   try {
     const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
@@ -317,62 +307,46 @@ export async function updateAppointmentUtil(
     const currentAppointment = appointmentDoc.data() as Appointment;
 
     // Handle requirement completion tracking
-    let completedPreRequirements =
-      currentAppointment.completedPreRequirements || [];
-    let completedPostRequirements =
-      currentAppointment.completedPostRequirements || [];
+    let completedPreRequirements = currentAppointment.completedPreRequirements || [];
+    let completedPostRequirements = currentAppointment.completedPostRequirements || [];
 
     if (data.completedPreRequirements) {
       // Validate that all IDs exist in the pre-requirements
-      const validPreReqIds = currentAppointment.preProcedureRequirements.map(
-        (req) => req.id
-      );
+      const validPreReqIds = currentAppointment.preProcedureRequirements.map(req => req.id);
 
       // Only perform validation and merging if the input is an array
       if (Array.isArray(data.completedPreRequirements)) {
         const invalidPreReqIds = data.completedPreRequirements.filter(
-          (id) => !validPreReqIds.includes(id)
+          id => !validPreReqIds.includes(id),
         );
 
         if (invalidPreReqIds.length > 0) {
-          throw new Error(
-            `Invalid pre-requirement IDs: ${invalidPreReqIds.join(", ")}`
-          );
+          throw new Error(`Invalid pre-requirement IDs: ${invalidPreReqIds.join(', ')}`);
         }
 
         // Update the completed pre-requirements
         completedPreRequirements = [
-          ...new Set([
-            ...completedPreRequirements,
-            ...data.completedPreRequirements,
-          ]),
+          ...new Set([...completedPreRequirements, ...data.completedPreRequirements]),
         ];
       }
     }
 
     if (data.completedPostRequirements) {
       // Validate that all IDs exist in the post-requirements
-      const validPostReqIds = currentAppointment.postProcedureRequirements.map(
-        (req) => req.id
-      );
+      const validPostReqIds = currentAppointment.postProcedureRequirements.map(req => req.id);
 
       if (Array.isArray(data.completedPostRequirements)) {
         const invalidPostReqIds = data.completedPostRequirements.filter(
-          (id) => !validPostReqIds.includes(id)
+          id => !validPostReqIds.includes(id),
         );
 
         if (invalidPostReqIds.length > 0) {
-          throw new Error(
-            `Invalid post-requirement IDs: ${invalidPostReqIds.join(", ")}`
-          );
+          throw new Error(`Invalid post-requirement IDs: ${invalidPostReqIds.join(', ')}`);
         }
 
         // Update the completed post-requirements
         completedPostRequirements = [
-          ...new Set([
-            ...completedPostRequirements,
-            ...data.completedPostRequirements,
-          ]),
+          ...new Set([...completedPostRequirements, ...data.completedPostRequirements]),
         ];
       }
     }
@@ -390,7 +364,7 @@ export async function updateAppointmentUtil(
     };
 
     // Remove undefined fields
-    Object.keys(updateData).forEach((key) => {
+    Object.keys(updateData).forEach(key => {
       if (updateData[key] === undefined) {
         delete updateData[key];
       }
@@ -399,20 +373,13 @@ export async function updateAppointmentUtil(
     // Handle status changes
     if (data.status && data.status !== currentAppointment.status) {
       // Handle confirmation
-      if (
-        data.status === AppointmentStatus.CONFIRMED &&
-        !updateData.confirmationTime
-      ) {
+      if (data.status === AppointmentStatus.CONFIRMED && !updateData.confirmationTime) {
         updateData.confirmationTime = Timestamp.now();
       }
 
       // Update the related calendar event status if needed
       if (currentAppointment.calendarEventId) {
-        await updateCalendarEventStatus(
-          db,
-          currentAppointment.calendarEventId,
-          data.status
-        );
+        await updateCalendarEventStatus(db, currentAppointment.calendarEventId, data.status);
       }
     }
 
@@ -422,9 +389,7 @@ export async function updateAppointmentUtil(
     // Fetch the updated appointment
     const updatedAppointmentDoc = await getDoc(appointmentRef);
     if (!updatedAppointmentDoc.exists()) {
-      throw new Error(
-        `Failed to retrieve updated appointment ${appointmentId}`
-      );
+      throw new Error(`Failed to retrieve updated appointment ${appointmentId}`);
     }
 
     return updatedAppointmentDoc.data() as Appointment;
@@ -444,7 +409,7 @@ export async function updateAppointmentUtil(
 async function updateCalendarEventStatus(
   db: Firestore,
   calendarEventId: string,
-  appointmentStatus: AppointmentStatus
+  appointmentStatus: AppointmentStatus,
 ): Promise<void> {
   try {
     const calendarEventRef = doc(db, CALENDAR_COLLECTION, calendarEventId);
@@ -459,17 +424,17 @@ async function updateCalendarEventStatus(
     let calendarStatus;
     switch (appointmentStatus) {
       case AppointmentStatus.CONFIRMED:
-        calendarStatus = "confirmed";
+        calendarStatus = 'confirmed';
         break;
       case AppointmentStatus.CANCELED_PATIENT:
       case AppointmentStatus.CANCELED_CLINIC:
-        calendarStatus = "canceled";
+        calendarStatus = 'canceled';
         break;
       case AppointmentStatus.RESCHEDULED_BY_CLINIC:
-        calendarStatus = "rescheduled";
+        calendarStatus = 'rescheduled';
         break;
       case AppointmentStatus.COMPLETED:
-        calendarStatus = "completed";
+        calendarStatus = 'completed';
         break;
       default:
         // For other states, don't update the calendar status
@@ -495,12 +460,10 @@ async function updateCalendarEventStatus(
  */
 export async function getAppointmentByIdUtil(
   db: Firestore,
-  appointmentId: string
+  appointmentId: string,
 ): Promise<Appointment | null> {
   try {
-    const appointmentDoc = await getDoc(
-      doc(db, APPOINTMENTS_COLLECTION, appointmentId)
-    );
+    const appointmentDoc = await getDoc(doc(db, APPOINTMENTS_COLLECTION, appointmentId));
 
     if (!appointmentDoc.exists()) {
       return null;
@@ -522,52 +485,44 @@ export async function getAppointmentByIdUtil(
  */
 export async function searchAppointmentsUtil(
   db: Firestore,
-  params: SearchAppointmentsParams
+  params: SearchAppointmentsParams,
 ): Promise<{ appointments: Appointment[]; lastDoc: DocumentSnapshot | null }> {
   try {
     const constraints: QueryConstraint[] = [];
 
     // Add filters based on provided params
     if (params.patientId) {
-      constraints.push(where("patientId", "==", params.patientId));
+      constraints.push(where('patientId', '==', params.patientId));
     }
 
     if (params.practitionerId) {
-      constraints.push(where("practitionerId", "==", params.practitionerId));
+      constraints.push(where('practitionerId', '==', params.practitionerId));
     }
 
     if (params.clinicBranchId) {
-      constraints.push(where("clinicBranchId", "==", params.clinicBranchId));
+      constraints.push(where('clinicBranchId', '==', params.clinicBranchId));
     }
 
     if (params.startDate) {
-      constraints.push(
-        where(
-          "appointmentStartTime",
-          ">=",
-          Timestamp.fromDate(params.startDate)
-        )
-      );
+      constraints.push(where('appointmentStartTime', '>=', Timestamp.fromDate(params.startDate)));
     }
 
     if (params.endDate) {
-      constraints.push(
-        where("appointmentStartTime", "<=", Timestamp.fromDate(params.endDate))
-      );
+      constraints.push(where('appointmentStartTime', '<=', Timestamp.fromDate(params.endDate)));
     }
 
     if (params.status) {
       if (Array.isArray(params.status)) {
         // If multiple statuses, use in operator
-        constraints.push(where("status", "in", params.status));
+        constraints.push(where('status', 'in', params.status));
       } else {
         // Single status
-        constraints.push(where("status", "==", params.status));
+        constraints.push(where('status', '==', params.status));
       }
     }
 
     // Add ordering
-    constraints.push(orderBy("appointmentStartTime", "asc"));
+    constraints.push(orderBy('appointmentStartTime', 'asc'));
 
     // Add pagination if specified
     if (params.limit) {
@@ -583,19 +538,15 @@ export async function searchAppointmentsUtil(
     const querySnapshot = await getDocs(q);
 
     // Extract results
-    const appointments = querySnapshot.docs.map(
-      (doc) => doc.data() as Appointment
-    );
+    const appointments = querySnapshot.docs.map(doc => doc.data() as Appointment);
 
     // Get last document for pagination
     const lastDoc =
-      querySnapshot.docs.length > 0
-        ? querySnapshot.docs[querySnapshot.docs.length - 1]
-        : null;
+      querySnapshot.docs.length > 0 ? querySnapshot.docs[querySnapshot.docs.length - 1] : null;
 
     return { appointments, lastDoc };
   } catch (error) {
-    console.error("Error searching appointments:", error);
+    console.error('Error searching appointments:', error);
     throw error;
   }
 }

package/src/services/appointment/utils/extended-procedure.utils.ts

@@ -7,6 +7,7 @@ import {
 } from '../../../types/appointment';
 import { getAppointmentOrThrow, initializeMetadata } from './zone-management.utils';
 import { PROCEDURES_COLLECTION } from '../../../types/procedure';
+import { initializeFormsForExtendedProcedure, removeFormsForExtendedProcedure } from './form-initialization.utils';
 
 /**
  * Aggregates products from a procedure into appointmentProducts
@@ -134,6 +135,16 @@ export async function addExtendedProcedureUtil(
   // Create extended procedure info
   const extendedProcedureInfo = await createExtendedProcedureInfo(db, procedureId);
 
+  // Get procedure data for forms and products
+  const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
+  const procedureSnap = await getDoc(procedureRef);
+  
+  if (!procedureSnap.exists()) {
+    throw new Error(`Procedure with ID ${procedureId} not found`);
+  }
+  
+  const procedureData = procedureSnap.data();
+
   // Aggregate products
   const updatedProducts = await aggregateProductsFromProcedure(
     db,
@@ -141,6 +152,28 @@ export async function addExtendedProcedureUtil(
     metadata.appointmentProducts || []
   );
 
+  // Initialize forms for extended procedure
+  let updatedLinkedFormIds = appointment.linkedFormIds || [];
+  let updatedLinkedForms = appointment.linkedForms || [];
+  let updatedPendingUserFormsIds = appointment.pendingUserFormsIds || [];
+
+  if (procedureData.documentationTemplates && procedureData.documentationTemplates.length > 0) {
+    const formInitResult = await initializeFormsForExtendedProcedure(
+      db,
+      appointmentId,
+      procedureId,
+      procedureData.documentationTemplates,
+      appointment.patientId,
+      appointment.practitionerId,
+      appointment.clinicBranchId
+    );
+
+    // Merge form IDs and info
+    updatedLinkedFormIds = [...updatedLinkedFormIds, ...formInitResult.allLinkedFormIds];
+    updatedLinkedForms = [...updatedLinkedForms, ...formInitResult.initializedFormsInfo];
+    updatedPendingUserFormsIds = [...updatedPendingUserFormsIds, ...formInitResult.pendingUserFormsIds];
+  }
+
   // Add extended procedure
   const extendedProcedures = [...(metadata.extendedProcedures || []), extendedProcedureInfo];
 
@@ -149,6 +182,9 @@ export async function addExtendedProcedureUtil(
   await updateDoc(appointmentRef, {
     'metadata.extendedProcedures': extendedProcedures,
     'metadata.appointmentProducts': updatedProducts,
+    linkedFormIds: updatedLinkedFormIds,
+    linkedForms: updatedLinkedForms,
+    pendingUserFormsIds: updatedPendingUserFormsIds,
     updatedAt: serverTimestamp(),
   });
 
@@ -191,11 +227,28 @@ export async function removeExtendedProcedureUtil(
     p => p.procedureId !== procedureId
   );
 
+  // Remove forms associated with this procedure
+  const removedFormIds = await removeFormsForExtendedProcedure(db, appointmentId, procedureId);
+  
+  // Update appointment form arrays
+  const updatedLinkedFormIds = (appointment.linkedFormIds || []).filter(
+    formId => !removedFormIds.includes(formId)
+  );
+  const updatedLinkedForms = (appointment.linkedForms || []).filter(
+    form => !removedFormIds.includes(form.formId)
+  );
+  const updatedPendingUserFormsIds = (appointment.pendingUserFormsIds || []).filter(
+    formId => !removedFormIds.includes(formId)
+  );
+
   // Update appointment
   const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
   await updateDoc(appointmentRef, {
     'metadata.extendedProcedures': metadata.extendedProcedures,
     'metadata.appointmentProducts': updatedProducts,
+    linkedFormIds: updatedLinkedFormIds,
+    linkedForms: updatedLinkedForms,
+    pendingUserFormsIds: updatedPendingUserFormsIds,
     updatedAt: serverTimestamp(),
   });