@blackcode_sa/metaestetics-api 1.6.24 → 1.6.25

package/dist/admin/index.d.mts

@@ -455,6 +455,19 @@ declare enum TreatmentBenefit {
     CIRCULATION_IMPROVEMENT = "circulation_improvement"
 }
 
+/**
+ * Reference to a documentation template with metadata
+ * @property templateId - ID of the documentation template
+ * @property isUserForm - Whether this template is filled by users
+ * @property isRequired - Whether this template is required
+ * @property sortingOrder - The display order of this template
+ */
+interface TechnologyDocumentationTemplate {
+    templateId: string;
+    isUserForm: boolean;
+    isRequired: boolean;
+    sortingOrder: number;
+}
 /**
  * Technology used in medical procedures
  * Technologies are now a top-level collection that reference their full path in the hierarchy
@@ -472,7 +485,7 @@ declare enum TreatmentBenefit {
  * @property contraindications - List of conditions requiring special attention
  * @property benefits - List of expected benefits from the procedure
  * @property certificationRequirement - Required certification level and specialties
- * @property documentationTemplates - List of documentation templates required for this technology
+ * @property documentationTemplates - List of documentation template references
  * @property isActive - Whether the technology is active in the system
  * @property createdAt - Creation date
  * @property updatedAt - Last update date
@@ -493,7 +506,7 @@ interface Technology {
     contraindications: Contraindication[];
     benefits: TreatmentBenefit[];
     certificationRequirement: CertificationRequirement;
-    documentationTemplates?: DocumentTemplate[];
+    documentationTemplates?: TechnologyDocumentationTemplate[];
     isActive: boolean;
     createdAt: Date;
     updatedAt: Date;
@@ -597,7 +610,7 @@ interface Procedure {
     /** Certification requirements for performing this procedure */
     certificationRequirement: CertificationRequirement;
     /** Documentation templates required for this procedure */
-    documentationTemplates: DocumentTemplate[];
+    documentationTemplates: TechnologyDocumentationTemplate[];
     /** ID of the practitioner who performs this procedure */
     practitionerId: string;
     /** ID of the clinic branch where this procedure is performed */
@@ -2518,6 +2531,21 @@ declare class DocumentManagerAdminService {
      * @returns An object containing initializedFormsInfo, pendingUserFormsIds, and allLinkedTemplateIds.
      */
     batchInitializeAppointmentForms(dbBatch: admin.firestore.WriteBatch, appointmentId: string, procedureIdForForms: string, procedureTemplates: DocumentTemplate[], patientId: string, practitionerId: string, clinicId: string, nowMillis: number): InitializeAppointmentFormsResult;
+    /**
+     * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
+     * using the TechnologyDocumentationTemplate references.
+     *
+     * @param dbBatch - The Firestore batch to add operations to.
+     * @param appointmentId - The ID of the newly created appointment.
+     * @param procedureIdForForms - The ID of the procedure associated with this appointment.
+     * @param technologyTemplates - Array of technology documentation template references.
+     * @param patientId - ID of the patient.
+     * @param practitionerId - ID of the practitioner associated with the procedure.
+     * @param clinicId - ID of the clinic where the procedure is performed.
+     * @param nowMillis - Current timestamp in milliseconds for createdAt/updatedAt.
+     * @returns An object containing initializedFormsInfo, pendingUserFormsIds, and allLinkedTemplateIds.
+     */
+    batchInitializeAppointmentFormsFromTechnologyTemplates(dbBatch: admin.firestore.WriteBatch, appointmentId: string, procedureIdForForms: string, technologyTemplates: TechnologyDocumentationTemplate[], patientId: string, practitionerId: string, clinicId: string, nowMillis: number): Promise<InitializeAppointmentFormsResult>;
 }
 
 /**

package/dist/admin/index.d.ts

@@ -455,6 +455,19 @@ declare enum TreatmentBenefit {
     CIRCULATION_IMPROVEMENT = "circulation_improvement"
 }
 
+/**
+ * Reference to a documentation template with metadata
+ * @property templateId - ID of the documentation template
+ * @property isUserForm - Whether this template is filled by users
+ * @property isRequired - Whether this template is required
+ * @property sortingOrder - The display order of this template
+ */
+interface TechnologyDocumentationTemplate {
+    templateId: string;
+    isUserForm: boolean;
+    isRequired: boolean;
+    sortingOrder: number;
+}
 /**
  * Technology used in medical procedures
  * Technologies are now a top-level collection that reference their full path in the hierarchy
@@ -472,7 +485,7 @@ declare enum TreatmentBenefit {
  * @property contraindications - List of conditions requiring special attention
  * @property benefits - List of expected benefits from the procedure
  * @property certificationRequirement - Required certification level and specialties
- * @property documentationTemplates - List of documentation templates required for this technology
+ * @property documentationTemplates - List of documentation template references
  * @property isActive - Whether the technology is active in the system
  * @property createdAt - Creation date
  * @property updatedAt - Last update date
@@ -493,7 +506,7 @@ interface Technology {
     contraindications: Contraindication[];
     benefits: TreatmentBenefit[];
     certificationRequirement: CertificationRequirement;
-    documentationTemplates?: DocumentTemplate[];
+    documentationTemplates?: TechnologyDocumentationTemplate[];
     isActive: boolean;
     createdAt: Date;
     updatedAt: Date;
@@ -597,7 +610,7 @@ interface Procedure {
     /** Certification requirements for performing this procedure */
     certificationRequirement: CertificationRequirement;
     /** Documentation templates required for this procedure */
-    documentationTemplates: DocumentTemplate[];
+    documentationTemplates: TechnologyDocumentationTemplate[];
     /** ID of the practitioner who performs this procedure */
     practitionerId: string;
     /** ID of the clinic branch where this procedure is performed */
@@ -2518,6 +2531,21 @@ declare class DocumentManagerAdminService {
      * @returns An object containing initializedFormsInfo, pendingUserFormsIds, and allLinkedTemplateIds.
      */
     batchInitializeAppointmentForms(dbBatch: admin.firestore.WriteBatch, appointmentId: string, procedureIdForForms: string, procedureTemplates: DocumentTemplate[], patientId: string, practitionerId: string, clinicId: string, nowMillis: number): InitializeAppointmentFormsResult;
+    /**
+     * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
+     * using the TechnologyDocumentationTemplate references.
+     *
+     * @param dbBatch - The Firestore batch to add operations to.
+     * @param appointmentId - The ID of the newly created appointment.
+     * @param procedureIdForForms - The ID of the procedure associated with this appointment.
+     * @param technologyTemplates - Array of technology documentation template references.
+     * @param patientId - ID of the patient.
+     * @param practitionerId - ID of the practitioner associated with the procedure.
+     * @param clinicId - ID of the clinic where the procedure is performed.
+     * @param nowMillis - Current timestamp in milliseconds for createdAt/updatedAt.
+     * @returns An object containing initializedFormsInfo, pendingUserFormsIds, and allLinkedTemplateIds.
+     */
+    batchInitializeAppointmentFormsFromTechnologyTemplates(dbBatch: admin.firestore.WriteBatch, appointmentId: string, procedureIdForForms: string, technologyTemplates: TechnologyDocumentationTemplate[], patientId: string, practitionerId: string, clinicId: string, nowMillis: number): Promise<InitializeAppointmentFormsResult>;
 }
 
 /**

package/dist/admin/index.js

@@ -127,6 +127,7 @@ var MediaType = /* @__PURE__ */ ((MediaType2) => {
 var APPOINTMENTS_COLLECTION = "appointments";
 
 // src/types/documentation-templates/index.ts
+var DOCUMENTATION_TEMPLATES_COLLECTION = "documentation-templates";
 var USER_FORMS_SUBCOLLECTION = "user-forms";
 var DOCTOR_FORMS_SUBCOLLECTION = "doctor-forms";
 
@@ -202,9 +203,9 @@ var Logger = class {
 
 // src/admin/notifications/notifications.admin.ts
 var NotificationsAdmin = class {
-  constructor(firestore12) {
+  constructor(firestore13) {
     this.expo = new import_expo_server_sdk.Expo();
-    this.db = firestore12 || admin.firestore();
+    this.db = firestore13 || admin.firestore();
   }
   /**
    * Dohvata notifikaciju po ID-u
@@ -923,8 +924,8 @@ var ClinicAggregationService = class {
    * Constructor for ClinicAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore12) {
-    this.db = firestore12 || admin3.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin3.firestore();
   }
   /**
    * Adds clinic information to a clinic group when a new clinic is created
@@ -1398,8 +1399,8 @@ var ClinicAggregationService = class {
 var admin4 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID2 = "calendar";
 var PractitionerAggregationService = class {
-  constructor(firestore12) {
-    this.db = firestore12 || admin4.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin4.firestore();
   }
   /**
    * Adds practitioner information to a clinic when a new practitioner is created
@@ -1734,8 +1735,8 @@ var PractitionerAggregationService = class {
 var admin5 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID3 = "calendar";
 var ProcedureAggregationService = class {
-  constructor(firestore12) {
-    this.db = firestore12 || admin5.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin5.firestore();
   }
   /**
    * Adds procedure information to a practitioner when a new procedure is created
@@ -2119,8 +2120,8 @@ var ProcedureAggregationService = class {
 var admin6 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID4 = "calendar";
 var PatientAggregationService = class {
-  constructor(firestore12) {
-    this.db = firestore12 || admin6.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin6.firestore();
   }
   // --- Methods for Patient Creation --- >
   // No specific aggregations defined for patient creation in the plan.
@@ -2252,8 +2253,8 @@ var PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME = "patientRequirements";
 // src/admin/requirements/patient-requirements.admin.service.ts
 var admin7 = __toESM(require("firebase-admin"));
 var PatientRequirementsAdminService = class {
-  constructor(firestore12) {
-    this.db = firestore12 || admin7.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin7.firestore();
     this.notificationsAdmin = new NotificationsAdmin(this.db);
   }
   /**
@@ -2581,8 +2582,8 @@ var PatientRequirementsAdminService = class {
 // src/admin/calendar/calendar.admin.service.ts
 var admin8 = __toESM(require("firebase-admin"));
 var CalendarAdminService = class {
-  constructor(firestore12) {
-    this.db = firestore12 || admin8.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin8.firestore();
     Logger.info("[CalendarAdminService] Initialized.");
   }
   /**
@@ -2699,9 +2700,9 @@ var BaseMailingService = class {
    * @param firestore Firestore instance provided by the caller
    * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
    */
-  constructor(firestore12, mailgunClient) {
+  constructor(firestore13, mailgunClient) {
     var _a;
-    this.db = firestore12;
+    this.db = firestore13;
     this.mailgunClient = mailgunClient;
     if (!this.db) {
       Logger.error("[BaseMailingService] No Firestore instance provided");
@@ -2845,8 +2846,8 @@ var BaseMailingService = class {
 var patientAppointmentConfirmedTemplate = "<h1>Appointment Confirmed</h1><p>Dear {{patientName}},</p><p>Your appointment for {{procedureName}} on {{appointmentDate}} at {{appointmentTime}} with {{practitionerName}} at {{clinicName}} has been confirmed.</p><p>Thank you!</p>";
 var clinicAppointmentRequestedTemplate = "<h1>New Appointment Request</h1><p>Hello {{clinicName}} Admin,</p><p>A new appointment for {{procedureName}} has been requested by {{patientName}} for {{appointmentDate}} at {{appointmentTime}} with {{practitionerName}}.</p><p>Please review and confirm in the admin panel.</p>";
 var AppointmentMailingService = class extends BaseMailingService {
-  constructor(firestore12, mailgunClient) {
-    super(firestore12, mailgunClient);
+  constructor(firestore13, mailgunClient) {
+    super(firestore13, mailgunClient);
     this.DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
     Logger.info("[AppointmentMailingService] Initialized.");
   }
@@ -2995,8 +2996,8 @@ var AppointmentAggregationService = class {
    * @param mailgunClient - An initialized Mailgun client instance.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(mailgunClient, firestore12) {
-    this.db = firestore12 || admin10.firestore();
+  constructor(mailgunClient, firestore13) {
+    this.db = firestore13 || admin10.firestore();
     this.appointmentMailingService = new AppointmentMailingService(
       this.db,
       mailgunClient
@@ -4006,8 +4007,8 @@ var PractitionerInviteMailingService = class extends BaseMailingService {
    * @param firestore Firestore instance provided by the caller
    * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
    */
-  constructor(firestore12, mailgunClient) {
-    super(firestore12, mailgunClient);
+  constructor(firestore13, mailgunClient) {
+    super(firestore13, mailgunClient);
     this.DEFAULT_REGISTRATION_URL = "https://metaesthetics.net/register";
     this.DEFAULT_SUBJECT = "You've Been Invited to Join as a Practitioner";
     this.DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
@@ -4245,7 +4246,7 @@ var PractitionerInviteMailingService = class extends BaseMailingService {
 };
 
 // src/admin/booking/booking.admin.ts
-var admin11 = __toESM(require("firebase-admin"));
+var admin12 = __toESM(require("firebase-admin"));
 
 // src/admin/booking/booking.calculator.ts
 var import_firestore2 = require("firebase/firestore");
@@ -4679,9 +4680,10 @@ var BookingAvailabilityCalculator = class {
 BookingAvailabilityCalculator.DEFAULT_INTERVAL_MINUTES = 15;
 
 // src/admin/documentation-templates/document-manager.admin.ts
+var admin11 = __toESM(require("firebase-admin"));
 var DocumentManagerAdminService = class {
-  constructor(firestore12) {
-    this.db = firestore12;
+  constructor(firestore13) {
+    this.db = firestore13;
   }
   /**
    * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
@@ -4755,6 +4757,92 @@ var DocumentManagerAdminService = class {
     }
     return { initializedFormsInfo, pendingUserFormsIds, allLinkedTemplateIds };
   }
+  /**
+   * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
+   * using the TechnologyDocumentationTemplate references.
+   *
+   * @param dbBatch - The Firestore batch to add operations to.
+   * @param appointmentId - The ID of the newly created appointment.
+   * @param procedureIdForForms - The ID of the procedure associated with this appointment.
+   * @param technologyTemplates - Array of technology documentation template references.
+   * @param patientId - ID of the patient.
+   * @param practitionerId - ID of the practitioner associated with the procedure.
+   * @param clinicId - ID of the clinic where the procedure is performed.
+   * @param nowMillis - Current timestamp in milliseconds for createdAt/updatedAt.
+   * @returns An object containing initializedFormsInfo, pendingUserFormsIds, and allLinkedTemplateIds.
+   */
+  async batchInitializeAppointmentFormsFromTechnologyTemplates(dbBatch, appointmentId, procedureIdForForms, technologyTemplates, patientId, practitionerId, clinicId, nowMillis) {
+    const initializedFormsInfo = [];
+    const pendingUserFormsIds = [];
+    const allLinkedTemplateIds = [];
+    if (!technologyTemplates || technologyTemplates.length === 0) {
+      console.log(
+        `[DocManagerAdmin] No document templates to initialize for appointment ${appointmentId}.`
+      );
+      return {
+        initializedFormsInfo,
+        pendingUserFormsIds,
+        allLinkedTemplateIds
+      };
+    }
+    const templateIds = technologyTemplates.map((t) => t.templateId);
+    const templatesSnapshot = await this.db.collection(DOCUMENTATION_TEMPLATES_COLLECTION).where(admin11.firestore.FieldPath.documentId(), "in", templateIds).get();
+    const templatesMap = /* @__PURE__ */ new Map();
+    templatesSnapshot.forEach((doc) => {
+      templatesMap.set(doc.id, doc.data());
+    });
+    for (const templateRef of technologyTemplates) {
+      const template = templatesMap.get(templateRef.templateId);
+      if (!template) {
+        console.warn(
+          `[DocManagerAdmin] Template ${templateRef.templateId} not found in Firestore.`
+        );
+        continue;
+      }
+      const isUserForm = templateRef.isUserForm;
+      const isRequired = templateRef.isRequired;
+      const formSubcollectionPath = isUserForm ? USER_FORMS_SUBCOLLECTION : DOCTOR_FORMS_SUBCOLLECTION;
+      const filledDocumentId = this.db.collection(APPOINTMENTS_COLLECTION).doc(appointmentId).collection(formSubcollectionPath).doc().id;
+      if (isUserForm && isRequired) {
+        pendingUserFormsIds.push(filledDocumentId);
+      }
+      allLinkedTemplateIds.push(filledDocumentId);
+      const initialStatus = "pending" /* PENDING */;
+      const filledDocumentData = {
+        id: filledDocumentId,
+        templateId: templateRef.templateId,
+        templateVersion: template.version,
+        isUserForm,
+        isRequired,
+        appointmentId,
+        procedureId: procedureIdForForms,
+        patientId,
+        practitionerId,
+        clinicId,
+        createdAt: nowMillis,
+        updatedAt: nowMillis,
+        values: {},
+        status: initialStatus
+      };
+      const docRef = this.db.collection(APPOINTMENTS_COLLECTION).doc(appointmentId).collection(formSubcollectionPath).doc(filledDocumentId);
+      dbBatch.set(docRef, filledDocumentData);
+      const linkedForm = {
+        formId: filledDocumentData.id,
+        templateId: template.id,
+        templateVersion: template.version,
+        title: template.title,
+        isUserForm: filledDocumentData.isUserForm,
+        isRequired: filledDocumentData.isRequired,
+        status: filledDocumentData.status,
+        path: docRef.path
+      };
+      initializedFormsInfo.push(linkedForm);
+      console.log(
+        `[DocManagerAdmin] Added FilledDocument ${filledDocumentId} (template: ${template.id}) and its LinkedFormInfo to batch for appointment ${appointmentId}.`
+      );
+    }
+    return { initializedFormsInfo, pendingUserFormsIds, allLinkedTemplateIds };
+  }
 };
 
 // src/admin/booking/booking.admin.ts
@@ -4763,8 +4851,8 @@ var BookingAdmin = class {
    * Creates a new BookingAdmin instance
    * @param firestore - Firestore instance provided by the caller
    */
-  constructor(firestore12) {
-    this.db = firestore12 || admin11.firestore();
+  constructor(firestore13) {
+    this.db = firestore13 || admin12.firestore();
     this.documentManagerAdmin = new DocumentManagerAdminService(this.db);
   }
   /**
@@ -4781,8 +4869,8 @@ var BookingAdmin = class {
       console.log(
         `[BookingAdmin] Getting available slots for clinic ${clinicId}, practitioner ${practitionerId}, procedure ${procedureId}`
       );
-      const start = timeframe.start instanceof Date ? admin11.firestore.Timestamp.fromDate(timeframe.start) : timeframe.start;
-      const end = timeframe.end instanceof Date ? admin11.firestore.Timestamp.fromDate(timeframe.end) : timeframe.end;
+      const start = timeframe.start instanceof Date ? admin12.firestore.Timestamp.fromDate(timeframe.start) : timeframe.start;
+      const end = timeframe.end instanceof Date ? admin12.firestore.Timestamp.fromDate(timeframe.end) : timeframe.end;
       const clinicDoc = await this.db.collection("clinics").doc(clinicId).get();
       if (!clinicDoc.exists) {
         throw new Error(`Clinic ${clinicId} not found`);
@@ -4821,7 +4909,7 @@ var BookingAdmin = class {
       const result = BookingAvailabilityCalculator.calculateSlots(request);
       return {
         availableSlots: result.availableSlots.map((slot) => ({
-          start: admin11.firestore.Timestamp.fromMillis(slot.start.toMillis())
+          start: admin12.firestore.Timestamp.fromMillis(slot.start.toMillis())
         }))
       };
     } catch (error) {
@@ -4924,8 +5012,8 @@ var BookingAdmin = class {
       `[BookingAdmin] Orchestrating appointment creation for patient ${data.patientId} by user ${authenticatedUserId}`
     );
     const batch = this.db.batch();
-    const adminTsNow = admin11.firestore.Timestamp.now();
-    const serverTimestampValue = admin11.firestore.FieldValue.serverTimestamp();
+    const adminTsNow = admin12.firestore.Timestamp.now();
+    const serverTimestampValue = admin12.firestore.FieldValue.serverTimestamp();
     try {
       if (!data.patientId || !data.procedureId || !data.appointmentStartTime || !data.appointmentEndTime) {
         return {
@@ -5022,7 +5110,7 @@ var BookingAdmin = class {
         fullName: `${(patientSensitiveData == null ? void 0 : patientSensitiveData.firstName) || ""} ${(patientSensitiveData == null ? void 0 : patientSensitiveData.lastName) || ""}`.trim() || patientProfileData.displayName,
         email: (patientSensitiveData == null ? void 0 : patientSensitiveData.email) || "",
         phone: (patientSensitiveData == null ? void 0 : patientSensitiveData.phoneNumber) || patientProfileData.phoneNumber || null,
-        dateOfBirth: (patientSensitiveData == null ? void 0 : patientSensitiveData.dateOfBirth) || patientProfileData.dateOfBirth || admin11.firestore.Timestamp.now(),
+        dateOfBirth: (patientSensitiveData == null ? void 0 : patientSensitiveData.dateOfBirth) || patientProfileData.dateOfBirth || admin12.firestore.Timestamp.now(),
         gender: (patientSensitiveData == null ? void 0 : patientSensitiveData.gender) || "other" /* OTHER */
       };
       const procedureCategory = procedure.category;
@@ -5072,9 +5160,11 @@ var BookingAdmin = class {
       if (procedure.documentationTemplates && Array.isArray(procedure.documentationTemplates)) {
         pendingUserFormsIds = procedure.documentationTemplates.filter(
           (template) => template.isUserForm && template.isRequired
-        ).map((template) => template.id);
+        ).map(
+          (template) => template.templateId
+        );
         linkedFormIds = procedure.documentationTemplates.map(
-          (template) => template.id
+          (template) => template.templateId
         );
       }
       const newAppointmentId = this.db.collection(APPOINTMENTS_COLLECTION).doc().id;
@@ -5162,7 +5252,7 @@ var BookingAdmin = class {
       let pendingUserFormTemplateIds = [];
       let allLinkedFormTemplateIds = [];
       if (procedure.documentationTemplates && Array.isArray(procedure.documentationTemplates) && procedure.documentationTemplates.length > 0) {
-        const formInitResult = this.documentManagerAdmin.batchInitializeAppointmentForms(
+        const formInitResult = await this.documentManagerAdmin.batchInitializeAppointmentFormsFromTechnologyTemplates(
           batch,
           newAppointmentId,
           procedure.id,