@blackcode_sa/metaestetics-api 1.7.28 → 1.7.30

package/dist/admin/index.d.mts

@@ -2896,4 +2896,12 @@ declare class AppointmentMailingService extends BaseMailingService {
     sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any>;
 }
 
-export { APPOINTMENTS_COLLECTION, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentMediaItem, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateAppointmentData, type CreateAppointmentHttpData, type DoctorInfo, DocumentManagerAdminService, type FilledDocument, FilledFormsAggregationService, type InitializeAppointmentFormsResult, type LinkedFormInfo, Logger, MediaType, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientReviewInfo, PaymentStatus, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, PractitionerInviteMailingService, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureExtendedInfo, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type SearchAppointmentsParams, type TimeInterval, type UpdateAppointmentData, UserRole };
+/**
+ * Ensures that the free consultation infrastructure exists in the database
+ * Creates category, subcategory, and technology if they don't exist
+ * @param db - Firestore database instance (optional, defaults to admin.firestore())
+ * @returns Promise<boolean> - Always returns true after ensuring infrastructure exists
+ */
+declare function freeConsultationInfrastructure(db?: admin.firestore.Firestore): Promise<boolean>;
+
+export { APPOINTMENTS_COLLECTION, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentMediaItem, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateAppointmentData, type CreateAppointmentHttpData, type DoctorInfo, DocumentManagerAdminService, type FilledDocument, FilledFormsAggregationService, type InitializeAppointmentFormsResult, type LinkedFormInfo, Logger, MediaType, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientReviewInfo, PaymentStatus, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, PractitionerInviteMailingService, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureExtendedInfo, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type SearchAppointmentsParams, type TimeInterval, type UpdateAppointmentData, UserRole, freeConsultationInfrastructure };

package/dist/admin/index.d.ts

@@ -2896,4 +2896,12 @@ declare class AppointmentMailingService extends BaseMailingService {
     sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any>;
 }
 
-export { APPOINTMENTS_COLLECTION, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentMediaItem, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateAppointmentData, type CreateAppointmentHttpData, type DoctorInfo, DocumentManagerAdminService, type FilledDocument, FilledFormsAggregationService, type InitializeAppointmentFormsResult, type LinkedFormInfo, Logger, MediaType, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientReviewInfo, PaymentStatus, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, PractitionerInviteMailingService, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureExtendedInfo, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type SearchAppointmentsParams, type TimeInterval, type UpdateAppointmentData, UserRole };
+/**
+ * Ensures that the free consultation infrastructure exists in the database
+ * Creates category, subcategory, and technology if they don't exist
+ * @param db - Firestore database instance (optional, defaults to admin.firestore())
+ * @returns Promise<boolean> - Always returns true after ensuring infrastructure exists
+ */
+declare function freeConsultationInfrastructure(db?: admin.firestore.Firestore): Promise<boolean>;
+
+export { APPOINTMENTS_COLLECTION, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentMediaItem, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateAppointmentData, type CreateAppointmentHttpData, type DoctorInfo, DocumentManagerAdminService, type FilledDocument, FilledFormsAggregationService, type InitializeAppointmentFormsResult, type LinkedFormInfo, Logger, MediaType, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientReviewInfo, PaymentStatus, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, PractitionerInviteMailingService, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureExtendedInfo, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type SearchAppointmentsParams, type TimeInterval, type UpdateAppointmentData, UserRole, freeConsultationInfrastructure };

package/dist/admin/index.js

@@ -58,7 +58,8 @@ __export(index_exports, {
   PractitionerTokenStatus: () => PractitionerTokenStatus,
   ProcedureAggregationService: () => ProcedureAggregationService,
   ReviewsAggregationService: () => ReviewsAggregationService,
-  UserRole: () => UserRole
+  UserRole: () => UserRole,
+  freeConsultationInfrastructure: () => freeConsultationInfrastructure
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -205,9 +206,9 @@ var Logger = class {
 
 // src/admin/notifications/notifications.admin.ts
 var NotificationsAdmin = class {
-  constructor(firestore15) {
+  constructor(firestore16) {
     this.expo = new import_expo_server_sdk.Expo();
-    this.db = firestore15 || admin.firestore();
+    this.db = firestore16 || admin.firestore();
   }
   /**
    * Dohvata notifikaciju po ID-u
@@ -926,8 +927,8 @@ var ClinicAggregationService = class {
    * Constructor for ClinicAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin3.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin3.firestore();
   }
   /**
    * Adds clinic information to a clinic group when a new clinic is created
@@ -1439,8 +1440,8 @@ var ClinicAggregationService = class {
 var admin4 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID2 = "calendar";
 var PractitionerAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin4.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin4.firestore();
   }
   /**
    * Adds practitioner information to a clinic when a new practitioner is created
@@ -1775,8 +1776,8 @@ var PractitionerAggregationService = class {
 var admin5 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID3 = "calendar";
 var ProcedureAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin5.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin5.firestore();
   }
   /**
    * Adds procedure information to a practitioner when a new procedure is created
@@ -2291,8 +2292,8 @@ var ProcedureAggregationService = class {
 var admin6 = __toESM(require("firebase-admin"));
 var CALENDAR_SUBCOLLECTION_ID4 = "calendar";
 var PatientAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin6.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin6.firestore();
   }
   // --- Methods for Patient Creation --- >
   // No specific aggregations defined for patient creation in the plan.
@@ -2424,8 +2425,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(firestore15) {
-    this.db = firestore15 || admin7.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin7.firestore();
     this.notificationsAdmin = new NotificationsAdmin(this.db);
   }
   /**
@@ -2753,8 +2754,8 @@ var PatientRequirementsAdminService = class {
 // src/admin/calendar/calendar.admin.service.ts
 var admin8 = __toESM(require("firebase-admin"));
 var CalendarAdminService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin8.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin8.firestore();
     Logger.info("[CalendarAdminService] Initialized.");
   }
   /**
@@ -3037,9 +3038,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(firestore15, mailgunClient) {
+  constructor(firestore16, mailgunClient) {
     var _a;
-    this.db = firestore15;
+    this.db = firestore16;
     this.mailgunClient = mailgunClient;
     if (!this.db) {
       Logger.error("[BaseMailingService] No Firestore instance provided");
@@ -3183,8 +3184,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(firestore15, mailgunClient) {
-    super(firestore15, mailgunClient);
+  constructor(firestore16, mailgunClient) {
+    super(firestore16, mailgunClient);
     this.DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
     Logger.info("[AppointmentMailingService] Initialized.");
   }
@@ -3333,8 +3334,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, firestore15) {
-    this.db = firestore15 || admin10.firestore();
+  constructor(mailgunClient, firestore16) {
+    this.db = firestore16 || admin10.firestore();
     this.appointmentMailingService = new AppointmentMailingService(
       this.db,
       mailgunClient
@@ -4590,8 +4591,8 @@ var FilledFormsAggregationService = class {
    * Constructor for FilledFormsAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin11.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin11.firestore();
     Logger.info("[FilledFormsAggregationService] Initialized");
   }
   /**
@@ -4785,8 +4786,8 @@ var ReviewsAggregationService = class {
    * Constructor for ReviewsAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin12.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin12.firestore();
   }
   /**
    * Process a newly created review and update all related entities
@@ -5331,8 +5332,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(firestore15, mailgunClient) {
-    super(firestore15, mailgunClient);
+  constructor(firestore16, mailgunClient) {
+    super(firestore16, 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";
@@ -6006,8 +6007,8 @@ BookingAvailabilityCalculator.DEFAULT_INTERVAL_MINUTES = 15;
 // src/admin/documentation-templates/document-manager.admin.ts
 var admin13 = __toESM(require("firebase-admin"));
 var DocumentManagerAdminService = class {
-  constructor(firestore15) {
-    this.db = firestore15;
+  constructor(firestore16) {
+    this.db = firestore16;
   }
   /**
    * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
@@ -6176,8 +6177,8 @@ var BookingAdmin = class {
    * Creates a new BookingAdmin instance
    * @param firestore - Firestore instance provided by the caller
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin14.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin14.firestore();
     this.documentManagerAdmin = new DocumentManagerAdminService(this.db);
   }
   /**
@@ -6779,6 +6780,116 @@ var BookingAdmin = class {
   }
 };
 
+// src/admin/free-consultation/free-consultation-utils.admin.ts
+var admin15 = __toESM(require("firebase-admin"));
+
+// src/backoffice/types/category.types.ts
+var CATEGORIES_COLLECTION = "backoffice_categories";
+
+// src/backoffice/types/subcategory.types.ts
+var SUBCATEGORIES_COLLECTION = "subcategories";
+
+// src/backoffice/types/technology.types.ts
+var TECHNOLOGIES_COLLECTION = "technologies";
+
+// src/admin/free-consultation/free-consultation-utils.admin.ts
+async function freeConsultationInfrastructure(db) {
+  const firestore16 = db || admin15.firestore();
+  try {
+    console.log(
+      "[freeConsultationInfrastructure] Checking free consultation infrastructure..."
+    );
+    const technologyRef = firestore16.collection(TECHNOLOGIES_COLLECTION).doc("free-consultation-tech");
+    const technologyDoc = await technologyRef.get();
+    if (technologyDoc.exists) {
+      console.log(
+        "[freeConsultationInfrastructure] Free consultation infrastructure already exists"
+      );
+      return true;
+    }
+    console.log(
+      "[freeConsultationInfrastructure] Creating free consultation infrastructure..."
+    );
+    await createFreeConsultationInfrastructure(firestore16);
+    console.log(
+      "[freeConsultationInfrastructure] Successfully created free consultation infrastructure"
+    );
+    return true;
+  } catch (error) {
+    console.error(
+      "[freeConsultationInfrastructure] Error ensuring infrastructure:",
+      error
+    );
+    throw error;
+  }
+}
+async function createFreeConsultationInfrastructure(db) {
+  const batch = db.batch();
+  const now = /* @__PURE__ */ new Date();
+  const categoryRef = db.collection(CATEGORIES_COLLECTION).doc("consultation");
+  const categoryData = {
+    id: "consultation",
+    name: "Consultation",
+    description: "Professional consultation services for treatment planning and assessment",
+    family: "aesthetics" /* AESTHETICS */,
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(categoryRef, categoryData);
+  const subcategoryRef = db.collection(CATEGORIES_COLLECTION).doc("consultation").collection(SUBCATEGORIES_COLLECTION).doc("free-consultation");
+  const subcategoryData = {
+    id: "free-consultation",
+    name: "Free Consultation",
+    description: "Complimentary initial consultation to discuss treatment options and assess patient needs",
+    categoryId: "consultation",
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(subcategoryRef, subcategoryData);
+  const technologyRef = db.collection(TECHNOLOGIES_COLLECTION).doc("free-consultation-tech");
+  const technologyData = {
+    id: "free-consultation-tech",
+    name: "Free Consultation Technology",
+    description: "Technology framework for providing free initial consultations to patients",
+    family: "aesthetics" /* AESTHETICS */,
+    categoryId: "consultation",
+    subcategoryId: "free-consultation",
+    technicalDetails: "Standard consultation protocol for initial patient assessment",
+    requirements: {
+      pre: [],
+      // No pre-requirements for consultation
+      post: []
+      // No post-requirements for consultation
+    },
+    blockingConditions: [],
+    // No blocking conditions for consultation
+    contraindications: [],
+    // No contraindications for consultation
+    benefits: [
+      "IMPROVED_PATIENT_UNDERSTANDING",
+      "BETTER_TREATMENT_PLANNING",
+      "ENHANCED_PATIENT_CONFIDENCE"
+    ],
+    certificationRequirement: {
+      minimumLevel: "aesthetician" /* AESTHETICIAN */,
+      requiredSpecialties: []
+      // No required specialties for consultation
+    },
+    documentationTemplates: [],
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(technologyRef, technologyData);
+  await batch.commit();
+  console.log("[freeConsultationInfrastructure] Successfully created:");
+  console.log("  \u2713 Category: consultation");
+  console.log("  \u2713 Subcategory: free-consultation");
+  console.log("  \u2713 Technology: free-consultation-tech");
+}
+
 // src/admin/index.ts
 console.log("[Admin Module] Initialized and services exported.");
 TimestampUtils.enableServerMode();
@@ -6812,5 +6923,6 @@ TimestampUtils.enableServerMode();
   PractitionerTokenStatus,
   ProcedureAggregationService,
   ReviewsAggregationService,
-  UserRole
+  UserRole,
+  freeConsultationInfrastructure
 });

package/dist/admin/index.mjs

@@ -148,9 +148,9 @@ var Logger = class {
 
 // src/admin/notifications/notifications.admin.ts
 var NotificationsAdmin = class {
-  constructor(firestore15) {
+  constructor(firestore16) {
     this.expo = new Expo();
-    this.db = firestore15 || admin.firestore();
+    this.db = firestore16 || admin.firestore();
   }
   /**
    * Dohvata notifikaciju po ID-u
@@ -869,8 +869,8 @@ var ClinicAggregationService = class {
    * Constructor for ClinicAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin3.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin3.firestore();
   }
   /**
    * Adds clinic information to a clinic group when a new clinic is created
@@ -1382,8 +1382,8 @@ var ClinicAggregationService = class {
 import * as admin4 from "firebase-admin";
 var CALENDAR_SUBCOLLECTION_ID2 = "calendar";
 var PractitionerAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin4.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin4.firestore();
   }
   /**
    * Adds practitioner information to a clinic when a new practitioner is created
@@ -1718,8 +1718,8 @@ var PractitionerAggregationService = class {
 import * as admin5 from "firebase-admin";
 var CALENDAR_SUBCOLLECTION_ID3 = "calendar";
 var ProcedureAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin5.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin5.firestore();
   }
   /**
    * Adds procedure information to a practitioner when a new procedure is created
@@ -2234,8 +2234,8 @@ var ProcedureAggregationService = class {
 import * as admin6 from "firebase-admin";
 var CALENDAR_SUBCOLLECTION_ID4 = "calendar";
 var PatientAggregationService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin6.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin6.firestore();
   }
   // --- Methods for Patient Creation --- >
   // No specific aggregations defined for patient creation in the plan.
@@ -2367,8 +2367,8 @@ var PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME = "patientRequirements";
 // src/admin/requirements/patient-requirements.admin.service.ts
 import * as admin7 from "firebase-admin";
 var PatientRequirementsAdminService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin7.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin7.firestore();
     this.notificationsAdmin = new NotificationsAdmin(this.db);
   }
   /**
@@ -2696,8 +2696,8 @@ var PatientRequirementsAdminService = class {
 // src/admin/calendar/calendar.admin.service.ts
 import * as admin8 from "firebase-admin";
 var CalendarAdminService = class {
-  constructor(firestore15) {
-    this.db = firestore15 || admin8.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin8.firestore();
     Logger.info("[CalendarAdminService] Initialized.");
   }
   /**
@@ -2980,9 +2980,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(firestore15, mailgunClient) {
+  constructor(firestore16, mailgunClient) {
     var _a;
-    this.db = firestore15;
+    this.db = firestore16;
     this.mailgunClient = mailgunClient;
     if (!this.db) {
       Logger.error("[BaseMailingService] No Firestore instance provided");
@@ -3126,8 +3126,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(firestore15, mailgunClient) {
-    super(firestore15, mailgunClient);
+  constructor(firestore16, mailgunClient) {
+    super(firestore16, mailgunClient);
     this.DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
     Logger.info("[AppointmentMailingService] Initialized.");
   }
@@ -3276,8 +3276,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, firestore15) {
-    this.db = firestore15 || admin10.firestore();
+  constructor(mailgunClient, firestore16) {
+    this.db = firestore16 || admin10.firestore();
     this.appointmentMailingService = new AppointmentMailingService(
       this.db,
       mailgunClient
@@ -4533,8 +4533,8 @@ var FilledFormsAggregationService = class {
    * Constructor for FilledFormsAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin11.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin11.firestore();
     Logger.info("[FilledFormsAggregationService] Initialized");
   }
   /**
@@ -4728,8 +4728,8 @@ var ReviewsAggregationService = class {
    * Constructor for ReviewsAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin12.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin12.firestore();
   }
   /**
    * Process a newly created review and update all related entities
@@ -5274,8 +5274,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(firestore15, mailgunClient) {
-    super(firestore15, mailgunClient);
+  constructor(firestore16, mailgunClient) {
+    super(firestore16, 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";
@@ -5949,8 +5949,8 @@ BookingAvailabilityCalculator.DEFAULT_INTERVAL_MINUTES = 15;
 // src/admin/documentation-templates/document-manager.admin.ts
 import * as admin13 from "firebase-admin";
 var DocumentManagerAdminService = class {
-  constructor(firestore15) {
-    this.db = firestore15;
+  constructor(firestore16) {
+    this.db = firestore16;
   }
   /**
    * Adds operations to a Firestore batch to initialize all linked forms for a new appointment
@@ -6119,8 +6119,8 @@ var BookingAdmin = class {
    * Creates a new BookingAdmin instance
    * @param firestore - Firestore instance provided by the caller
    */
-  constructor(firestore15) {
-    this.db = firestore15 || admin14.firestore();
+  constructor(firestore16) {
+    this.db = firestore16 || admin14.firestore();
     this.documentManagerAdmin = new DocumentManagerAdminService(this.db);
   }
   /**
@@ -6722,6 +6722,116 @@ var BookingAdmin = class {
   }
 };
 
+// src/admin/free-consultation/free-consultation-utils.admin.ts
+import * as admin15 from "firebase-admin";
+
+// src/backoffice/types/category.types.ts
+var CATEGORIES_COLLECTION = "backoffice_categories";
+
+// src/backoffice/types/subcategory.types.ts
+var SUBCATEGORIES_COLLECTION = "subcategories";
+
+// src/backoffice/types/technology.types.ts
+var TECHNOLOGIES_COLLECTION = "technologies";
+
+// src/admin/free-consultation/free-consultation-utils.admin.ts
+async function freeConsultationInfrastructure(db) {
+  const firestore16 = db || admin15.firestore();
+  try {
+    console.log(
+      "[freeConsultationInfrastructure] Checking free consultation infrastructure..."
+    );
+    const technologyRef = firestore16.collection(TECHNOLOGIES_COLLECTION).doc("free-consultation-tech");
+    const technologyDoc = await technologyRef.get();
+    if (technologyDoc.exists) {
+      console.log(
+        "[freeConsultationInfrastructure] Free consultation infrastructure already exists"
+      );
+      return true;
+    }
+    console.log(
+      "[freeConsultationInfrastructure] Creating free consultation infrastructure..."
+    );
+    await createFreeConsultationInfrastructure(firestore16);
+    console.log(
+      "[freeConsultationInfrastructure] Successfully created free consultation infrastructure"
+    );
+    return true;
+  } catch (error) {
+    console.error(
+      "[freeConsultationInfrastructure] Error ensuring infrastructure:",
+      error
+    );
+    throw error;
+  }
+}
+async function createFreeConsultationInfrastructure(db) {
+  const batch = db.batch();
+  const now = /* @__PURE__ */ new Date();
+  const categoryRef = db.collection(CATEGORIES_COLLECTION).doc("consultation");
+  const categoryData = {
+    id: "consultation",
+    name: "Consultation",
+    description: "Professional consultation services for treatment planning and assessment",
+    family: "aesthetics" /* AESTHETICS */,
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(categoryRef, categoryData);
+  const subcategoryRef = db.collection(CATEGORIES_COLLECTION).doc("consultation").collection(SUBCATEGORIES_COLLECTION).doc("free-consultation");
+  const subcategoryData = {
+    id: "free-consultation",
+    name: "Free Consultation",
+    description: "Complimentary initial consultation to discuss treatment options and assess patient needs",
+    categoryId: "consultation",
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(subcategoryRef, subcategoryData);
+  const technologyRef = db.collection(TECHNOLOGIES_COLLECTION).doc("free-consultation-tech");
+  const technologyData = {
+    id: "free-consultation-tech",
+    name: "Free Consultation Technology",
+    description: "Technology framework for providing free initial consultations to patients",
+    family: "aesthetics" /* AESTHETICS */,
+    categoryId: "consultation",
+    subcategoryId: "free-consultation",
+    technicalDetails: "Standard consultation protocol for initial patient assessment",
+    requirements: {
+      pre: [],
+      // No pre-requirements for consultation
+      post: []
+      // No post-requirements for consultation
+    },
+    blockingConditions: [],
+    // No blocking conditions for consultation
+    contraindications: [],
+    // No contraindications for consultation
+    benefits: [
+      "IMPROVED_PATIENT_UNDERSTANDING",
+      "BETTER_TREATMENT_PLANNING",
+      "ENHANCED_PATIENT_CONFIDENCE"
+    ],
+    certificationRequirement: {
+      minimumLevel: "aesthetician" /* AESTHETICIAN */,
+      requiredSpecialties: []
+      // No required specialties for consultation
+    },
+    documentationTemplates: [],
+    isActive: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  batch.set(technologyRef, technologyData);
+  await batch.commit();
+  console.log("[freeConsultationInfrastructure] Successfully created:");
+  console.log("  \u2713 Category: consultation");
+  console.log("  \u2713 Subcategory: free-consultation");
+  console.log("  \u2713 Technology: free-consultation-tech");
+}
+
 // src/admin/index.ts
 console.log("[Admin Module] Initialized and services exported.");
 TimestampUtils.enableServerMode();
@@ -6754,5 +6864,6 @@ export {
   PractitionerTokenStatus,
   ProcedureAggregationService,
   ReviewsAggregationService,
-  UserRole
+  UserRole,
+  freeConsultationInfrastructure
 };

package/package.json

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

package/src/admin/free-consultation/free-consultation-utils.admin.ts

@@ -0,0 +1,147 @@
+import * as admin from "firebase-admin";
+import { ProcedureFamily } from "../../backoffice/types/static/procedure-family.types";
+import {
+  CertificationLevel,
+  CertificationSpecialty,
+} from "../../backoffice/types/static/certification.types";
+import { CATEGORIES_COLLECTION } from "../../backoffice/types/category.types";
+import { SUBCATEGORIES_COLLECTION } from "../../backoffice/types/subcategory.types";
+import { TECHNOLOGIES_COLLECTION } from "../../backoffice/types/technology.types";
+
+/**
+ * Ensures that the free consultation infrastructure exists in the database
+ * Creates category, subcategory, and technology if they don't exist
+ * @param db - Firestore database instance (optional, defaults to admin.firestore())
+ * @returns Promise<boolean> - Always returns true after ensuring infrastructure exists
+ */
+export async function freeConsultationInfrastructure(
+  db?: admin.firestore.Firestore
+): Promise<boolean> {
+  const firestore = db || admin.firestore();
+
+  try {
+    console.log(
+      "[freeConsultationInfrastructure] Checking free consultation infrastructure..."
+    );
+
+    // Check if the technology already exists
+    const technologyRef = firestore
+      .collection(TECHNOLOGIES_COLLECTION)
+      .doc("free-consultation-tech");
+
+    const technologyDoc = await technologyRef.get();
+
+    if (technologyDoc.exists) {
+      console.log(
+        "[freeConsultationInfrastructure] Free consultation infrastructure already exists"
+      );
+      return true;
+    }
+
+    console.log(
+      "[freeConsultationInfrastructure] Creating free consultation infrastructure..."
+    );
+
+    // Create the infrastructure in the correct order: Category → Subcategory → Technology
+    await createFreeConsultationInfrastructure(firestore);
+
+    console.log(
+      "[freeConsultationInfrastructure] Successfully created free consultation infrastructure"
+    );
+    return true;
+  } catch (error) {
+    console.error(
+      "[freeConsultationInfrastructure] Error ensuring infrastructure:",
+      error
+    );
+    throw error;
+  }
+}
+
+/**
+ * Creates the complete free consultation infrastructure
+ * @param db - Firestore database instance
+ */
+async function createFreeConsultationInfrastructure(
+  db: admin.firestore.Firestore
+): Promise<void> {
+  const batch = db.batch();
+  const now = new Date();
+
+  // 1. Create Category: "consultation"
+  const categoryRef = db.collection(CATEGORIES_COLLECTION).doc("consultation");
+  const categoryData = {
+    id: "consultation",
+    name: "Consultation",
+    description:
+      "Professional consultation services for treatment planning and assessment",
+    family: ProcedureFamily.AESTHETICS,
+    isActive: true,
+    createdAt: now,
+    updatedAt: now,
+  };
+  batch.set(categoryRef, categoryData);
+
+  // 2. Create Subcategory: "free-consultation"
+  const subcategoryRef = db
+    .collection(CATEGORIES_COLLECTION)
+    .doc("consultation")
+    .collection(SUBCATEGORIES_COLLECTION)
+    .doc("free-consultation");
+
+  const subcategoryData = {
+    id: "free-consultation",
+    name: "Free Consultation",
+    description:
+      "Complimentary initial consultation to discuss treatment options and assess patient needs",
+    categoryId: "consultation",
+    isActive: true,
+    createdAt: now,
+    updatedAt: now,
+  };
+  batch.set(subcategoryRef, subcategoryData);
+
+  // 3. Create Technology: "free-consultation-tech"
+  const technologyRef = db
+    .collection(TECHNOLOGIES_COLLECTION)
+    .doc("free-consultation-tech");
+  const technologyData = {
+    id: "free-consultation-tech",
+    name: "Free Consultation Technology",
+    description:
+      "Technology framework for providing free initial consultations to patients",
+    family: ProcedureFamily.AESTHETICS,
+    categoryId: "consultation",
+    subcategoryId: "free-consultation",
+    technicalDetails:
+      "Standard consultation protocol for initial patient assessment",
+    requirements: {
+      pre: [], // No pre-requirements for consultation
+      post: [], // No post-requirements for consultation
+    },
+    blockingConditions: [], // No blocking conditions for consultation
+    contraindications: [], // No contraindications for consultation
+    benefits: [
+      "IMPROVED_PATIENT_UNDERSTANDING",
+      "BETTER_TREATMENT_PLANNING",
+      "ENHANCED_PATIENT_CONFIDENCE",
+    ],
+    certificationRequirement: {
+      minimumLevel: CertificationLevel.AESTHETICIAN,
+      requiredSpecialties: [], // No required specialties for consultation
+    },
+    documentationTemplates: [],
+    isActive: true,
+    createdAt: now,
+    updatedAt: now,
+  };
+  batch.set(technologyRef, technologyData);
+
+  // Commit all changes atomically
+  await batch.commit();
+
+  console.log("[freeConsultationInfrastructure] Successfully created:");
+  console.log("  ✓ Category: consultation");
+  console.log("  ✓ Subcategory: free-consultation");
+  console.log("  ✓ Technology: free-consultation-tech");
+}

package/src/admin/index.ts

@@ -139,3 +139,6 @@ export * from "./aggregation/reviews/reviews.aggregation.service";
 // Re-export types that Cloud Functions might need direct access to
 export * from "../types/appointment";
 // Add other types as needed
+
+// Export free consultation utilities
+export * from "./free-consultation/free-consultation-utils.admin";