@blackcode_sa/metaestetics-api 1.12.29 → 1.12.31

package/dist/index.d.mts

@@ -3234,6 +3234,47 @@ interface UpdateMedicationData extends Partial<AddMedicationData> {
 }
 declare const DEFAULT_MEDICAL_INFO: Omit<PatientMedicalInfo, "patientId" | "lastUpdated" | "updatedBy">;
 
+declare const AESTHETIC_ANALYSIS_COLLECTION = "aesthetic-analysis";
+interface ClinicalFinding {
+    concernCategory: string;
+    concernName: string;
+    severityLevel?: string;
+    impactLevel?: string;
+    clinicalNotes?: string;
+}
+interface AssessmentScale {
+    scaleName: string;
+    scaleValue: string;
+    category: string;
+}
+interface PatientGoals {
+    treatmentTimeline?: string;
+    budgetRange?: string;
+    naturalnessPreference: number;
+    selectedGoalTemplate?: string;
+    priorities: string[];
+}
+interface AestheticAnalysis {
+    patientId: string;
+    lastUpdatedBy: string;
+    lastUpdatedByRole: 'PATIENT' | 'PRACTITIONER';
+    patientGoals: PatientGoals;
+    clinicalFindings: ClinicalFinding[];
+    assessmentScales: AssessmentScale[];
+    createdAt?: Timestamp | any;
+    updatedAt?: Timestamp | any;
+}
+interface CreateAestheticAnalysisData {
+    patientGoals: PatientGoals;
+    clinicalFindings: ClinicalFinding[];
+    assessmentScales: AssessmentScale[];
+}
+interface UpdateAestheticAnalysisData {
+    patientGoals?: PatientGoals;
+    clinicalFindings?: ClinicalFinding[];
+    assessmentScales?: AssessmentScale[];
+}
+
 declare const PATIENTS_COLLECTION = "patients";
 declare const PATIENT_SENSITIVE_INFO_COLLECTION = "sensitive-info";
 declare const PATIENT_MEDICAL_HISTORY_COLLECTION = "medical-history";
@@ -5237,7 +5278,7 @@ declare class ClinicService extends BaseService {
     private functions;
     constructor(db: Firestore, auth: Auth, app: FirebaseApp, clinicGroupService: ClinicGroupService, clinicAdminService: ClinicAdminService, mediaService: MediaService);
     /**
-     * Get timezone from coordinates using geo-tz library
+     * Get timezone from coordinates using tz-lookup library
      * @param lat Latitude
      * @param lng Longitude
      * @returns IANA timezone string
@@ -6969,4 +7010,4 @@ declare const getFirebaseApp: () => Promise<FirebaseApp>;
 declare const getFirebaseStorage: () => Promise<FirebaseStorage>;
 declare const getFirebaseFunctions: () => Promise<Functions>;
 
-export { APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, AuthService, type BaseDocumentElement, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, CALENDAR_COLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicBranchSetupData, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CreateAdminTokenData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DynamicTextElement, DynamicVariable, type EmergencyContact, EnvironmentalAllergySubtype, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, type Notification, NotificationService, NotificationStatus, NotificationType, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, type ParagraphElement, type PatientClinic, type PatientDoctor, PatientInstructionStatus, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedureProduct, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, ProductService, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, RequirementType, type Review, type ReviewRequestNotification, ReviewService, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };
+export { AESTHETIC_ANALYSIS_COLLECTION, APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AssessmentScale, AuthService, type BaseDocumentElement, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, CALENDAR_COLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicBranchSetupData, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFinding, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DynamicTextElement, DynamicVariable, type EmergencyContact, EnvironmentalAllergySubtype, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, type Notification, NotificationService, NotificationStatus, NotificationType, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, type ParagraphElement, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedureProduct, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, ProductService, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, RequirementType, type Review, type ReviewRequestNotification, ReviewService, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };

package/dist/index.d.ts

@@ -3234,6 +3234,47 @@ interface UpdateMedicationData extends Partial<AddMedicationData> {
 }
 declare const DEFAULT_MEDICAL_INFO: Omit<PatientMedicalInfo, "patientId" | "lastUpdated" | "updatedBy">;
 
+declare const AESTHETIC_ANALYSIS_COLLECTION = "aesthetic-analysis";
+interface ClinicalFinding {
+    concernCategory: string;
+    concernName: string;
+    severityLevel?: string;
+    impactLevel?: string;
+    clinicalNotes?: string;
+}
+interface AssessmentScale {
+    scaleName: string;
+    scaleValue: string;
+    category: string;
+}
+interface PatientGoals {
+    treatmentTimeline?: string;
+    budgetRange?: string;
+    naturalnessPreference: number;
+    selectedGoalTemplate?: string;
+    priorities: string[];
+}
+interface AestheticAnalysis {
+    patientId: string;
+    lastUpdatedBy: string;
+    lastUpdatedByRole: 'PATIENT' | 'PRACTITIONER';
+    patientGoals: PatientGoals;
+    clinicalFindings: ClinicalFinding[];
+    assessmentScales: AssessmentScale[];
+    createdAt?: Timestamp | any;
+    updatedAt?: Timestamp | any;
+}
+interface CreateAestheticAnalysisData {
+    patientGoals: PatientGoals;
+    clinicalFindings: ClinicalFinding[];
+    assessmentScales: AssessmentScale[];
+}
+interface UpdateAestheticAnalysisData {
+    patientGoals?: PatientGoals;
+    clinicalFindings?: ClinicalFinding[];
+    assessmentScales?: AssessmentScale[];
+}
+
 declare const PATIENTS_COLLECTION = "patients";
 declare const PATIENT_SENSITIVE_INFO_COLLECTION = "sensitive-info";
 declare const PATIENT_MEDICAL_HISTORY_COLLECTION = "medical-history";
@@ -5237,7 +5278,7 @@ declare class ClinicService extends BaseService {
     private functions;
     constructor(db: Firestore, auth: Auth, app: FirebaseApp, clinicGroupService: ClinicGroupService, clinicAdminService: ClinicAdminService, mediaService: MediaService);
     /**
-     * Get timezone from coordinates using geo-tz library
+     * Get timezone from coordinates using tz-lookup library
      * @param lat Latitude
      * @param lng Longitude
      * @returns IANA timezone string
@@ -6969,4 +7010,4 @@ declare const getFirebaseApp: () => Promise<FirebaseApp>;
 declare const getFirebaseStorage: () => Promise<FirebaseStorage>;
 declare const getFirebaseFunctions: () => Promise<Functions>;
 
-export { APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, AuthService, type BaseDocumentElement, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, CALENDAR_COLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicBranchSetupData, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CreateAdminTokenData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DynamicTextElement, DynamicVariable, type EmergencyContact, EnvironmentalAllergySubtype, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, type Notification, NotificationService, NotificationStatus, NotificationType, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, type ParagraphElement, type PatientClinic, type PatientDoctor, PatientInstructionStatus, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedureProduct, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, ProductService, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, RequirementType, type Review, type ReviewRequestNotification, ReviewService, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };
+export { AESTHETIC_ANALYSIS_COLLECTION, APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AssessmentScale, AuthService, type BaseDocumentElement, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, CALENDAR_COLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicBranchSetupData, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFinding, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DynamicTextElement, DynamicVariable, type EmergencyContact, EnvironmentalAllergySubtype, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, type Notification, NotificationService, NotificationStatus, NotificationType, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, type ParagraphElement, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedureProduct, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, ProductService, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, RequirementType, type Review, type ReviewRequestNotification, ReviewService, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AESTHETIC_ANALYSIS_COLLECTION: () => AESTHETIC_ANALYSIS_COLLECTION,
   APPOINTMENTS_COLLECTION: () => APPOINTMENTS_COLLECTION,
   AdminTokenStatus: () => AdminTokenStatus,
   AllergyType: () => AllergyType,
@@ -1248,6 +1249,9 @@ var DEFAULT_MEDICAL_INFO = {
   currentMedications: []
 };
 
+// src/types/patient/aesthetic-analysis.types.ts
+var AESTHETIC_ANALYSIS_COLLECTION = "aesthetic-analysis";
+
 // src/types/patient/index.ts
 var PATIENTS_COLLECTION = "patients";
 var PATIENT_SENSITIVE_INFO_COLLECTION = "sensitive-info";
@@ -8577,7 +8581,7 @@ var ClinicGroupService = class extends BaseService {
 // src/services/clinic/clinic.service.ts
 var import_firestore28 = require("firebase/firestore");
 var import_functions2 = require("firebase/functions");
-var import_geo_tz = require("geo-tz");
+var import_tz_lookup = __toESM(require("tz-lookup"));
 var import_geofire_common7 = require("geofire-common");
 var import_zod20 = require("zod");
 
@@ -9333,18 +9337,15 @@ var ClinicService = class extends BaseService {
     this.functions = (0, import_functions2.getFunctions)(app, "europe-west6");
   }
   /**
-   * Get timezone from coordinates using geo-tz library
+   * Get timezone from coordinates using tz-lookup library
    * @param lat Latitude
    * @param lng Longitude
    * @returns IANA timezone string
    */
   getTimezone(lat, lng) {
     try {
-      const timezones = (0, import_geo_tz.find)(lat, lng);
-      if (timezones && timezones.length > 0) {
-        return timezones[0];
-      }
-      return null;
+      const timezone = (0, import_tz_lookup.default)(lat, lng);
+      return timezone || null;
     } catch (error) {
       console.error("[CLINIC_SERVICE] Error getting timezone:", error);
       return null;
@@ -18280,6 +18281,7 @@ var RequirementType = /* @__PURE__ */ ((RequirementType2) => {
 })(RequirementType || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AESTHETIC_ANALYSIS_COLLECTION,
   APPOINTMENTS_COLLECTION,
   AdminTokenStatus,
   AllergyType,

package/dist/index.mjs

@@ -1148,6 +1148,9 @@ var DEFAULT_MEDICAL_INFO = {
   currentMedications: []
 };
 
+// src/types/patient/aesthetic-analysis.types.ts
+var AESTHETIC_ANALYSIS_COLLECTION = "aesthetic-analysis";
+
 // src/types/patient/index.ts
 var PATIENTS_COLLECTION = "patients";
 var PATIENT_SENSITIVE_INFO_COLLECTION = "sensitive-info";
@@ -8646,7 +8649,7 @@ import {
   arrayUnion as arrayUnion7
 } from "firebase/firestore";
 import { getFunctions as getFunctions2 } from "firebase/functions";
-import { find as findTimezone } from "geo-tz";
+import tzlookup from "tz-lookup";
 import {
   geohashForLocation as geohashForLocation4
 } from "geofire-common";
@@ -9433,18 +9436,15 @@ var ClinicService = class extends BaseService {
     this.functions = getFunctions2(app, "europe-west6");
   }
   /**
-   * Get timezone from coordinates using geo-tz library
+   * Get timezone from coordinates using tz-lookup library
    * @param lat Latitude
    * @param lng Longitude
    * @returns IANA timezone string
    */
   getTimezone(lat, lng) {
     try {
-      const timezones = findTimezone(lat, lng);
-      if (timezones && timezones.length > 0) {
-        return timezones[0];
-      }
-      return null;
+      const timezone = tzlookup(lat, lng);
+      return timezone || null;
     } catch (error) {
       console.error("[CLINIC_SERVICE] Error getting timezone:", error);
       return null;
@@ -18615,6 +18615,7 @@ var RequirementType = /* @__PURE__ */ ((RequirementType2) => {
   return RequirementType2;
 })(RequirementType || {});
 export {
+  AESTHETIC_ANALYSIS_COLLECTION,
   APPOINTMENTS_COLLECTION,
   AdminTokenStatus,
   AllergyType,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.12.29",
+  "version": "1.12.31",
   "description": "Firebase authentication service with anonymous upgrade support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -98,9 +98,9 @@
     "axios": "^1.8.3",
     "expo-server-sdk": "^3.13.0",
     "firebase-admin": "^13.0.2",
-    "geo-tz": "^8.1.4",
     "geofire-common": "^6.0.0",
     "luxon": "^3.7.1",
+    "tz-lookup": "^6.1.25",
     "zod": "^3.24.1"
   },
   "optionalDependencies": {

package/src/services/clinic/clinic.service.ts

@@ -18,7 +18,7 @@ import {
   arrayRemove,
 } from "firebase/firestore";
 import { getFunctions, httpsCallable } from "firebase/functions";
-import { find as findTimezone } from "geo-tz";
+import tzlookup from "tz-lookup";
 import { BaseService } from "../base.service";
 import {
   Clinic,
@@ -83,18 +83,15 @@ export class ClinicService extends BaseService {
   }
 
   /**
-   * Get timezone from coordinates using geo-tz library
+   * Get timezone from coordinates using tz-lookup library
    * @param lat Latitude
    * @param lng Longitude
    * @returns IANA timezone string
    */
   private getTimezone(lat: number, lng: number): string | null {
     try {
-      const timezones = findTimezone(lat, lng);
-      if (timezones && timezones.length > 0) {
-        return timezones[0];
-      }
-      return null;
+      const timezone = tzlookup(lat, lng);
+      return timezone || null;
     } catch (error) {
       console.error("[CLINIC_SERVICE] Error getting timezone:", error);
       return null;

package/src/services/patient/utils/aesthetic-analysis.utils.ts

@@ -0,0 +1,121 @@
+import { getDoc, updateDoc, setDoc, serverTimestamp, Firestore, doc } from 'firebase/firestore';
+import {
+  AestheticAnalysis,
+  CreateAestheticAnalysisData,
+  UpdateAestheticAnalysisData,
+  AESTHETIC_ANALYSIS_COLLECTION,
+  PATIENTS_COLLECTION,
+} from '../../../types/patient';
+import { UserRole } from '../../../types';
+import {
+  createAestheticAnalysisSchema,
+  updateAestheticAnalysisSchema,
+  aestheticAnalysisSchema,
+} from '../../../validations/patient/aesthetic-analysis.schema';
+import { getPatientDocRef } from './docs.utils';
+import { AuthError } from '../../../errors/auth.errors';
+import { getPractitionerProfileByUserRef } from './practitioner.utils';
+import { getClinicAdminByUserRef } from '../../clinic/utils/admin.utils';
+
+export const getAestheticAnalysisDocRef = (db: Firestore, patientId: string) => {
+  return doc(db, PATIENTS_COLLECTION, patientId, AESTHETIC_ANALYSIS_COLLECTION, patientId);
+};
+
+const checkAestheticAnalysisAccessUtil = async (
+  db: Firestore,
+  patientId: string,
+  requesterId: string,
+  requesterRoles: UserRole[]
+): Promise<void> => {
+  const patientDoc = await getDoc(getPatientDocRef(db, patientId));
+  if (!patientDoc.exists()) {
+    throw new Error('Patient profile not found');
+  }
+  const patientData = patientDoc.data() as any;
+
+  if (patientData.userRef && patientData.userRef === requesterId) {
+    return;
+  }
+
+  if (requesterRoles.includes(UserRole.PRACTITIONER)) {
+    const practitionerProfile = await getPractitionerProfileByUserRef(db, requesterId);
+    if (practitionerProfile && patientData.doctorIds?.includes(practitionerProfile.id)) {
+      return;
+    }
+  }
+
+  if (requesterRoles.includes(UserRole.CLINIC_ADMIN)) {
+    const adminProfile = await getClinicAdminByUserRef(db, requesterId);
+    if (adminProfile && adminProfile.clinicsManaged) {
+      const hasAccess = adminProfile.clinicsManaged.some((managedClinicId) =>
+        patientData.clinicIds?.includes(managedClinicId)
+      );
+      if (hasAccess) {
+        return;
+      }
+    }
+  }
+
+  throw new AuthError(
+    'Unauthorized access to aesthetic analysis.',
+    'AUTH/UNAUTHORIZED_ACCESS',
+    403
+  );
+};
+
+export const getAestheticAnalysisUtil = async (
+  db: Firestore,
+  patientId: string,
+  requesterId: string,
+  requesterRoles: UserRole[]
+): Promise<AestheticAnalysis | null> => {
+  await checkAestheticAnalysisAccessUtil(db, patientId, requesterId, requesterRoles);
+  
+  const docRef = getAestheticAnalysisDocRef(db, patientId);
+  const snapshot = await getDoc(docRef);
+  
+  if (!snapshot.exists()) {
+    return null;
+  }
+  
+  return aestheticAnalysisSchema.parse(snapshot.data());
+};
+
+export const createOrUpdateAestheticAnalysisUtil = async (
+  db: Firestore,
+  patientId: string,
+  data: CreateAestheticAnalysisData | UpdateAestheticAnalysisData,
+  requesterId: string,
+  requesterRoles: UserRole[],
+  isUpdate: boolean = false
+): Promise<void> => {
+  await checkAestheticAnalysisAccessUtil(db, patientId, requesterId, requesterRoles);
+  
+  const validatedData = isUpdate
+    ? updateAestheticAnalysisSchema.parse(data)
+    : createAestheticAnalysisSchema.parse(data);
+  
+  const docRef = getAestheticAnalysisDocRef(db, patientId);
+  const snapshot = await getDoc(docRef);
+  
+  const requesterRole = requesterRoles.includes(UserRole.PRACTITIONER) ? 'PRACTITIONER' : 'PATIENT';
+  
+  if (!snapshot.exists()) {
+    await setDoc(docRef, {
+      patientId,
+      ...validatedData,
+      lastUpdatedBy: requesterId,
+      lastUpdatedByRole: requesterRole,
+      createdAt: serverTimestamp(),
+      updatedAt: serverTimestamp(),
+    });
+  } else {
+    await updateDoc(docRef, {
+      ...validatedData,
+      lastUpdatedBy: requesterId,
+      lastUpdatedByRole: requesterRole,
+      updatedAt: serverTimestamp(),
+    });
+  }
+};
+

package/src/types/appointment/index.ts

@@ -76,8 +76,8 @@ export interface ProcedureExtendedInfo {
   procedureTechnologyName: string;
   procedureProductBrandId: string;
   procedureProductBrandName: string;
-  procedureProductId: string;
-  procedureProductName: string;
+  procedureProductId: string; // We need to have more than one product allowed in this data, this is coming from aggregation, so please update aggregation and this data type
+  procedureProductName: string; // We need to have more than one product allowed in this data, this is coming from aggregation, so please update aggregation and this data type
 }
 
 /**
@@ -134,7 +134,7 @@ export interface ZonePhotoUploadData {
 /**
  * Interface for billing information per zone
  */
-export interface BillingPerZone {
+export interface BillingPerZone { // We should rename this to ZoneItemData and we should expend it as per our documentations (will be used for both zone items in step 3 and summary and pricing in the step 4)
   /** Product name/description */
   Product: string;
   /** Product ID */
@@ -168,11 +168,11 @@ export interface FinalBilling {
   /** Final price including tax */
   finalPrice: number;
   /** Total final quantity across all zones */
-  finalQuantity: number;
+  finalQuantity: number; // Not sure we should keep this as well, we keep track of this per item
   /** Currency for the final billing */
   currency: Currency;
   /** Unit of measurement for the final billing */
-  unitOfMeasurement: PricingMeasure;
+  unitOfMeasurement: PricingMeasure; // NO need to keep this, we keep track of this per item
 }
 
 /**
@@ -180,15 +180,16 @@ export interface FinalBilling {
  */
 export interface AppointmentMetadata {
   /** Array of selected zones for the appointment */
-  selectedZones: string[] | null;
+  selectedZones: string[] | null; // We are not going to accept any structure (category.zone.subzone), here we will only accept zone (category.zone), nothing more, nothing less
   /** Map of zone photos with before/after images and notes */
-  zonePhotos: Record<string, BeforeAfterPerZone> | null;
+  zonePhotos: Record<string, BeforeAfterPerZone> | null; // head.forhead: {object}, head: {object}, but it can't have head.forhead.forhedLeft: {object}
   /** Map of billing information per zone */
-  zoneBilling: Record<string, BillingPerZone> | null;
+  zoneBilling: Record<string, BillingPerZone> | null; // This is going to change, name it zonesData, and expand this to accept more than one item per key (which is basically zone like category.zone)
   /** Final billing calculations for the appointment */
   finalbilling: FinalBilling | null;
   /** Final note for the appointment */
   finalizationNotes: string | null;
+  // TO-DO: We need to add extended procedures info (when we add multiple procedures, different than default one defined above)
 }
 
 /**

package/src/types/patient/aesthetic-analysis.types.ts

@@ -0,0 +1,52 @@
+import { Timestamp } from 'firebase/firestore';
+
+export const AESTHETIC_ANALYSIS_COLLECTION = 'aesthetic-analysis';
+
+export interface ClinicalFinding {
+  concernCategory: string;
+  concernName: string;
+  severityLevel?: string;
+  impactLevel?: string;
+  clinicalNotes?: string;
+}
+
+export interface AssessmentScale {
+  scaleName: string;
+  scaleValue: string;
+  category: string;
+}
+
+export interface PatientGoals {
+  treatmentTimeline?: string;
+  budgetRange?: string;
+  naturalnessPreference: number;
+  selectedGoalTemplate?: string;
+  priorities: string[];
+}
+
+export interface AestheticAnalysis {
+  patientId: string;
+  
+  lastUpdatedBy: string;
+  lastUpdatedByRole: 'PATIENT' | 'PRACTITIONER';
+  
+  patientGoals: PatientGoals;
+  clinicalFindings: ClinicalFinding[];
+  assessmentScales: AssessmentScale[];
+  
+  createdAt?: Timestamp | any;
+  updatedAt?: Timestamp | any;
+}
+
+export interface CreateAestheticAnalysisData {
+  patientGoals: PatientGoals;
+  clinicalFindings: ClinicalFinding[];
+  assessmentScales: AssessmentScale[];
+}
+
+export interface UpdateAestheticAnalysisData {
+  patientGoals?: PatientGoals;
+  clinicalFindings?: ClinicalFinding[];
+  assessmentScales?: AssessmentScale[];
+}
+

package/src/types/patient/index.ts

@@ -256,6 +256,7 @@ export interface RequesterInfo {
 }
 
 export * from "./medical-info.types";
+export * from "./aesthetic-analysis.types";
 
 // This is a type that combines all the patient data - used only in UI Frontend App
 export interface PatientProfileComplete {

package/src/types/tz-lookup.d.ts

@@ -0,0 +1,4 @@
+declare module 'tz-lookup' {
+  function tzlookup(lat: number, lng: number): string;
+  export default tzlookup;
+}

package/src/validations/patient/aesthetic-analysis.schema.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+
+export const clinicalFindingSchema = z.object({
+  concernCategory: z.string().min(1, 'Concern category is required'),
+  concernName: z.string().min(1, 'Concern name is required'),
+  severityLevel: z.string().optional(),
+  impactLevel: z.string().optional(),
+  clinicalNotes: z.string().optional(),
+});
+
+export const assessmentScaleSchema = z.object({
+  scaleName: z.string().min(1, 'Scale name is required'),
+  scaleValue: z.string().min(1, 'Scale value is required'),
+  category: z.string().min(1, 'Category is required'),
+});
+
+export const patientGoalsSchema = z.object({
+  treatmentTimeline: z.string().optional(),
+  budgetRange: z.string().optional(),
+  naturalnessPreference: z.number().min(0).max(100),
+  selectedGoalTemplate: z.string().optional(),
+  priorities: z.array(z.string()).default([]),
+});
+
+export const aestheticAnalysisSchema = z.object({
+  patientId: z.string().min(1, 'Patient ID is required'),
+  lastUpdatedBy: z.string().min(1, 'Last updated by is required'),
+  lastUpdatedByRole: z.enum(['PATIENT', 'PRACTITIONER']),
+  patientGoals: patientGoalsSchema,
+  clinicalFindings: z.array(clinicalFindingSchema).default([]),
+  assessmentScales: z.array(assessmentScaleSchema).default([]),
+  createdAt: z.any(),
+  updatedAt: z.any(),
+});
+
+export const createAestheticAnalysisSchema = z.object({
+  patientGoals: patientGoalsSchema,
+  clinicalFindings: z.array(clinicalFindingSchema).default([]),
+  assessmentScales: z.array(assessmentScaleSchema).default([]),
+});
+
+export const updateAestheticAnalysisSchema = z.object({
+  patientGoals: patientGoalsSchema.optional(),
+  clinicalFindings: z.array(clinicalFindingSchema).optional(),
+  assessmentScales: z.array(assessmentScaleSchema).optional(),
+});
+