@blackcode_sa/metaestetics-api 1.14.79 → 1.15.3

package/src/types/patient/pre-surgical-assessment.types.ts

@@ -0,0 +1,95 @@
+import { Timestamp } from 'firebase/firestore';
+
+export const PRE_SURGICAL_ASSESSMENT_COLLECTION = 'pre-surgical-assessment';
+
+export type PreSurgicalAssessmentStatus = 'incomplete' | 'ready_for_planning' | 'treatment_planned';
+
+export type ASAClassification = 'I' | 'II' | 'III' | 'IV';
+
+export interface AnesthesiaHistory {
+  previousAnesthesia: boolean;
+  adverseReactions?: boolean;
+  reactionDetails?: string;
+  preferredType?: 'local' | 'regional' | 'general' | 'sedation';
+  malignantHyperthermiaRisk?: boolean;
+}
+
+export type BleedingRiskLevel = 'low' | 'moderate' | 'high';
+
+export interface BleedingRisk {
+  level: BleedingRiskLevel;
+  anticoagulantUse: boolean;
+  anticoagulantDetails?: string;
+  bleedingDisorderHistory: boolean;
+  bleedingDisorderDetails?: string;
+}
+
+export type TissueQualityLevel = 'excellent' | 'good' | 'fair' | 'poor';
+
+export interface SurgicalSiteAssessment {
+  site: string;
+  skinQuality: TissueQualityLevel;
+  scarringHistory: 'none' | 'normal' | 'hypertrophic' | 'keloid';
+  tissueQuality: TissueQualityLevel;
+  previousSurgery: boolean;
+  previousSurgeryDetails?: string;
+  notes?: string;
+}
+
+export interface LabResult {
+  name: string;
+  value: string;
+  unit?: string;
+  date?: string;
+  isNormal?: boolean;
+  notes?: string;
+}
+
+export type SmokingStatus = 'never' | 'former' | 'current' | 'quit_recently';
+export type ClearanceStatus = 'not_required' | 'pending' | 'obtained' | 'denied';
+
+export interface PreSurgicalAssessment {
+  id: string;
+  patientId: string;
+  appointmentId?: string;
+
+  asaClassification?: ASAClassification;
+  anesthesiaHistory?: AnesthesiaHistory;
+  bleedingRisk?: BleedingRisk;
+  surgicalSiteAssessments: SurgicalSiteAssessment[];
+  labResults: LabResult[];
+  smokingStatus?: SmokingStatus;
+  clearance: ClearanceStatus;
+
+  completionPercentage: number;
+  status: PreSurgicalAssessmentStatus;
+
+  lastUpdatedBy: string;
+  lastUpdatedByRole: 'PATIENT' | 'PRACTITIONER';
+
+  createdAt?: Timestamp | any;
+  updatedAt?: Timestamp | any;
+}
+
+export interface CreatePreSurgicalAssessmentData {
+  patientId: string;
+  appointmentId?: string;
+  asaClassification?: ASAClassification;
+  anesthesiaHistory?: AnesthesiaHistory;
+  bleedingRisk?: BleedingRisk;
+  surgicalSiteAssessments?: SurgicalSiteAssessment[];
+  labResults?: LabResult[];
+  smokingStatus?: SmokingStatus;
+  clearance?: ClearanceStatus;
+}
+
+export interface UpdatePreSurgicalAssessmentData {
+  appointmentId?: string;
+  asaClassification?: ASAClassification;
+  anesthesiaHistory?: AnesthesiaHistory;
+  bleedingRisk?: BleedingRisk;
+  surgicalSiteAssessments?: SurgicalSiteAssessment[];
+  labResults?: LabResult[];
+  smokingStatus?: SmokingStatus;
+  clearance?: ClearanceStatus;
+}

package/src/types/patient/skin-quality-assessment.types.ts

@@ -0,0 +1,105 @@
+import { Timestamp } from 'firebase/firestore';
+
+export const SKIN_QUALITY_ASSESSMENT_COLLECTION = 'skin-quality-assessment';
+
+export type SkinQualityAssessmentStatus = 'incomplete' | 'ready_for_planning' | 'treatment_planned';
+
+export type SkinHydrationLevel = 'very_dry' | 'dry' | 'normal' | 'oily' | 'very_oily';
+export type SkinSensitivityLevel = 'none' | 'mild' | 'moderate' | 'severe';
+export type SkinElasticityLevel = 'excellent' | 'good' | 'fair' | 'poor';
+export type PoreSizeLevel = 'fine' | 'small' | 'medium' | 'large' | 'very_large';
+export type SkinTextureLevel = 'smooth' | 'slightly_rough' | 'rough' | 'very_rough';
+
+export interface SkinCharacteristics {
+  hydration: SkinHydrationLevel;
+  oiliness: SkinHydrationLevel;
+  sensitivity: SkinSensitivityLevel;
+  elasticity: SkinElasticityLevel;
+  poreSize: PoreSizeLevel;
+  texture: SkinTextureLevel;
+}
+
+export type SkinConditionType =
+  | 'acne'
+  | 'rosacea'
+  | 'melasma'
+  | 'hyperpigmentation'
+  | 'hypopigmentation'
+  | 'eczema'
+  | 'psoriasis'
+  | 'sun_damage'
+  | 'scarring'
+  | 'keratosis';
+
+export interface SkinConditionEntry {
+  type: SkinConditionType;
+  severity: string;
+  location?: string;
+  notes?: string;
+}
+
+export type SkinZone =
+  | 'forehead'
+  | 'periorbital'
+  | 'cheeks'
+  | 'nose'
+  | 'perioral'
+  | 'chin'
+  | 'neck'
+  | 'decolletage';
+
+export interface SkinZoneAssessment {
+  zone: SkinZone;
+  pigmentation: string;
+  texture: string;
+  vascularity: string;
+  photoaging: string;
+  notes?: string;
+}
+
+export type FitzpatrickType = 'I' | 'II' | 'III' | 'IV' | 'V' | 'VI';
+export type GlogauClassification = 'I' | 'II' | 'III' | 'IV';
+export type ElastosisGrade = 'none' | 'mild' | 'moderate' | 'severe';
+
+export interface SkinQualityScales {
+  fitzpatrick?: FitzpatrickType;
+  glogau?: GlogauClassification;
+  elastosis?: ElastosisGrade;
+}
+
+export interface SkinQualityAssessment {
+  id: string;
+  patientId: string;
+  appointmentId?: string;
+
+  characteristics?: SkinCharacteristics;
+  conditions: SkinConditionEntry[];
+  zoneAssessments: SkinZoneAssessment[];
+  scales: SkinQualityScales;
+
+  completionPercentage: number;
+  status: SkinQualityAssessmentStatus;
+
+  lastUpdatedBy: string;
+  lastUpdatedByRole: 'PATIENT' | 'PRACTITIONER';
+
+  createdAt?: Timestamp | any;
+  updatedAt?: Timestamp | any;
+}
+
+export interface CreateSkinQualityAssessmentData {
+  patientId: string;
+  appointmentId?: string;
+  characteristics?: SkinCharacteristics;
+  conditions?: SkinConditionEntry[];
+  zoneAssessments?: SkinZoneAssessment[];
+  scales?: SkinQualityScales;
+}
+
+export interface UpdateSkinQualityAssessmentData {
+  appointmentId?: string;
+  characteristics?: SkinCharacteristics;
+  conditions?: SkinConditionEntry[];
+  zoneAssessments?: SkinZoneAssessment[];
+  scales?: SkinQualityScales;
+}

package/src/validations/patient/body-assessment.schema.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+
+export const bodyZoneAssessmentSchema = z.object({
+  zone: z.enum([
+    'abdomen', 'flanks', 'back', 'upper_arms', 'thighs_inner',
+    'thighs_outer', 'buttocks', 'chest', 'knees', 'submental',
+  ]),
+  fatDeposit: z.enum(['none', 'mild', 'moderate', 'severe']),
+  skinLaxity: z.enum(['none', 'mild', 'moderate', 'severe']),
+  stretchMarks: z.enum(['none', 'mild', 'moderate', 'severe']),
+  cellulite: z.enum(['none', 'mild', 'moderate', 'severe']),
+  muscleDefinition: z.enum(['well_defined', 'moderate', 'poor', 'none']),
+  notes: z.string().optional(),
+});
+
+export const bodyCompositionSchema = z.object({
+  bmi: z.number().optional(),
+  bodyFatPercentage: z.number().min(0).max(100).optional(),
+  waistHipRatio: z.number().optional(),
+  weight: z.number().optional(),
+  height: z.number().optional(),
+});
+
+export const bodyMeasurementsSchema = z.object({
+  waist: z.number().optional(),
+  hips: z.number().optional(),
+  chest: z.number().optional(),
+  upperArm: z.number().optional(),
+  thigh: z.number().optional(),
+  units: z.enum(['cm', 'inches']),
+});
+
+export const bodySymmetrySchema = z.object({
+  overallSymmetry: z.enum(['symmetric', 'mild_asymmetry', 'moderate_asymmetry', 'significant_asymmetry']),
+  notes: z.string().optional(),
+  affectedAreas: z.array(z.string()).optional(),
+});
+
+export const createBodyAssessmentSchema = z.object({
+  patientId: z.string().min(1, 'Patient ID is required'),
+  appointmentId: z.string().optional(),
+  selectedZones: z.array(z.enum([
+    'abdomen', 'flanks', 'back', 'upper_arms', 'thighs_inner',
+    'thighs_outer', 'buttocks', 'chest', 'knees', 'submental',
+  ])).optional(),
+  zoneAssessments: z.array(bodyZoneAssessmentSchema).optional(),
+  composition: bodyCompositionSchema.optional(),
+  measurements: bodyMeasurementsSchema.optional(),
+  symmetry: bodySymmetrySchema.optional(),
+});
+
+export const updateBodyAssessmentSchema = z.object({
+  appointmentId: z.string().optional(),
+  selectedZones: z.array(z.enum([
+    'abdomen', 'flanks', 'back', 'upper_arms', 'thighs_inner',
+    'thighs_outer', 'buttocks', 'chest', 'knees', 'submental',
+  ])).optional(),
+  zoneAssessments: z.array(bodyZoneAssessmentSchema).optional(),
+  composition: bodyCompositionSchema.optional(),
+  measurements: bodyMeasurementsSchema.optional(),
+  symmetry: bodySymmetrySchema.optional(),
+}).partial();
+
+export const bodyAssessmentSchema = z.object({
+  id: z.string(),
+  patientId: z.string(),
+  appointmentId: z.string().optional(),
+  selectedZones: z.array(z.enum([
+    'abdomen', 'flanks', 'back', 'upper_arms', 'thighs_inner',
+    'thighs_outer', 'buttocks', 'chest', 'knees', 'submental',
+  ])),
+  zoneAssessments: z.array(bodyZoneAssessmentSchema),
+  composition: bodyCompositionSchema.optional(),
+  measurements: bodyMeasurementsSchema.optional(),
+  symmetry: bodySymmetrySchema.optional(),
+  completionPercentage: z.number().min(0).max(100),
+  status: z.enum(['incomplete', 'ready_for_planning', 'treatment_planned']),
+  lastUpdatedBy: z.string(),
+  lastUpdatedByRole: z.enum(['PATIENT', 'PRACTITIONER']),
+  createdAt: z.any(),
+  updatedAt: z.any(),
+});

package/src/validations/patient/hair-scalp-assessment.schema.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+export const hairLossPatternSchema = z.object({
+  type: z.enum(['androgenetic', 'diffuse', 'areata', 'traction', 'scarring', 'telogen_effluvium']),
+  norwoodStage: z.enum(['I', 'II', 'IIa', 'III', 'IIIa', 'III_vertex', 'IV', 'IVa', 'V', 'Va', 'VI', 'VII']).optional(),
+  ludwigStage: z.enum(['I', 'II', 'III']).optional(),
+  onsetDuration: z.string().optional(),
+  familyHistory: z.boolean().optional(),
+  notes: z.string().optional(),
+});
+
+export const hairCharacteristicsSchema = z.object({
+  type: z.enum(['straight', 'wavy', 'curly', 'coily']),
+  density: z.enum(['high', 'medium', 'low', 'very_low']),
+  color: z.enum(['black', 'dark_brown', 'brown', 'light_brown', 'blonde', 'red', 'grey', 'white']),
+  texture: z.enum(['fine', 'medium', 'coarse']),
+  diameter: z.enum(['thin', 'medium', 'thick']).optional(),
+});
+
+export const scalpConditionSchema = z.object({
+  scaliness: z.enum(['none', 'mild', 'moderate', 'severe']),
+  redness: z.enum(['none', 'mild', 'moderate', 'severe']),
+  sebum: z.enum(['dry', 'normal', 'oily', 'very_oily']),
+  folliculitis: z.boolean(),
+  scarring: z.boolean(),
+  notes: z.string().optional(),
+});
+
+export const hairLossZoneAssessmentSchema = z.object({
+  zone: z.enum([
+    'frontal', 'temporal_left', 'temporal_right', 'mid_scalp',
+    'vertex', 'occipital', 'parietal_left', 'parietal_right',
+  ]),
+  miniaturization: z.enum(['none', 'mild', 'moderate', 'severe']),
+  density: z.enum(['high', 'medium', 'low', 'very_low']),
+  notes: z.string().optional(),
+});
+
+export const createHairScalpAssessmentSchema = z.object({
+  patientId: z.string().min(1, 'Patient ID is required'),
+  appointmentId: z.string().optional(),
+  hairLossPattern: hairLossPatternSchema.optional(),
+  hairCharacteristics: hairCharacteristicsSchema.optional(),
+  scalpCondition: scalpConditionSchema.optional(),
+  zoneAssessments: z.array(hairLossZoneAssessmentSchema).optional(),
+});
+
+export const updateHairScalpAssessmentSchema = z.object({
+  appointmentId: z.string().optional(),
+  hairLossPattern: hairLossPatternSchema.optional(),
+  hairCharacteristics: hairCharacteristicsSchema.optional(),
+  scalpCondition: scalpConditionSchema.optional(),
+  zoneAssessments: z.array(hairLossZoneAssessmentSchema).optional(),
+}).partial();
+
+export const hairScalpAssessmentSchema = z.object({
+  id: z.string(),
+  patientId: z.string(),
+  appointmentId: z.string().optional(),
+  hairLossPattern: hairLossPatternSchema.optional(),
+  hairCharacteristics: hairCharacteristicsSchema.optional(),
+  scalpCondition: scalpConditionSchema.optional(),
+  zoneAssessments: z.array(hairLossZoneAssessmentSchema),
+  completionPercentage: z.number().min(0).max(100),
+  status: z.enum(['incomplete', 'ready_for_planning', 'treatment_planned']),
+  lastUpdatedBy: z.string(),
+  lastUpdatedByRole: z.enum(['PATIENT', 'PRACTITIONER']),
+  createdAt: z.any(),
+  updatedAt: z.any(),
+});

package/src/validations/patient/pre-surgical-assessment.schema.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+
+export const anesthesiaHistorySchema = z.object({
+  previousAnesthesia: z.boolean(),
+  adverseReactions: z.boolean().optional(),
+  reactionDetails: z.string().optional(),
+  preferredType: z.enum(['local', 'regional', 'general', 'sedation']).optional(),
+  malignantHyperthermiaRisk: z.boolean().optional(),
+});
+
+export const bleedingRiskSchema = z.object({
+  level: z.enum(['low', 'moderate', 'high']),
+  anticoagulantUse: z.boolean(),
+  anticoagulantDetails: z.string().optional(),
+  bleedingDisorderHistory: z.boolean(),
+  bleedingDisorderDetails: z.string().optional(),
+});
+
+export const surgicalSiteAssessmentSchema = z.object({
+  site: z.string().min(1),
+  skinQuality: z.enum(['excellent', 'good', 'fair', 'poor']),
+  scarringHistory: z.enum(['none', 'normal', 'hypertrophic', 'keloid']),
+  tissueQuality: z.enum(['excellent', 'good', 'fair', 'poor']),
+  previousSurgery: z.boolean(),
+  previousSurgeryDetails: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const labResultSchema = z.object({
+  name: z.string().min(1),
+  value: z.string().min(1),
+  unit: z.string().optional(),
+  date: z.string().optional(),
+  isNormal: z.boolean().optional(),
+  notes: z.string().optional(),
+});
+
+export const createPreSurgicalAssessmentSchema = z.object({
+  patientId: z.string().min(1, 'Patient ID is required'),
+  appointmentId: z.string().optional(),
+  asaClassification: z.enum(['I', 'II', 'III', 'IV']).optional(),
+  anesthesiaHistory: anesthesiaHistorySchema.optional(),
+  bleedingRisk: bleedingRiskSchema.optional(),
+  surgicalSiteAssessments: z.array(surgicalSiteAssessmentSchema).optional(),
+  labResults: z.array(labResultSchema).optional(),
+  smokingStatus: z.enum(['never', 'former', 'current', 'quit_recently']).optional(),
+  clearance: z.enum(['not_required', 'pending', 'obtained', 'denied']).optional(),
+});
+
+export const updatePreSurgicalAssessmentSchema = z.object({
+  appointmentId: z.string().optional(),
+  asaClassification: z.enum(['I', 'II', 'III', 'IV']).optional(),
+  anesthesiaHistory: anesthesiaHistorySchema.optional(),
+  bleedingRisk: bleedingRiskSchema.optional(),
+  surgicalSiteAssessments: z.array(surgicalSiteAssessmentSchema).optional(),
+  labResults: z.array(labResultSchema).optional(),
+  smokingStatus: z.enum(['never', 'former', 'current', 'quit_recently']).optional(),
+  clearance: z.enum(['not_required', 'pending', 'obtained', 'denied']).optional(),
+}).partial();
+
+export const preSurgicalAssessmentSchema = z.object({
+  id: z.string(),
+  patientId: z.string(),
+  appointmentId: z.string().optional(),
+  asaClassification: z.enum(['I', 'II', 'III', 'IV']).optional(),
+  anesthesiaHistory: anesthesiaHistorySchema.optional(),
+  bleedingRisk: bleedingRiskSchema.optional(),
+  surgicalSiteAssessments: z.array(surgicalSiteAssessmentSchema),
+  labResults: z.array(labResultSchema),
+  smokingStatus: z.enum(['never', 'former', 'current', 'quit_recently']).optional(),
+  clearance: z.enum(['not_required', 'pending', 'obtained', 'denied']),
+  completionPercentage: z.number().min(0).max(100),
+  status: z.enum(['incomplete', 'ready_for_planning', 'treatment_planned']),
+  lastUpdatedBy: z.string(),
+  lastUpdatedByRole: z.enum(['PATIENT', 'PRACTITIONER']),
+  createdAt: z.any(),
+  updatedAt: z.any(),
+});

package/src/validations/patient/skin-quality-assessment.schema.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+export const skinCharacteristicsSchema = z.object({
+  hydration: z.enum(['very_dry', 'dry', 'normal', 'oily', 'very_oily']),
+  oiliness: z.enum(['very_dry', 'dry', 'normal', 'oily', 'very_oily']),
+  sensitivity: z.enum(['none', 'mild', 'moderate', 'severe']),
+  elasticity: z.enum(['excellent', 'good', 'fair', 'poor']),
+  poreSize: z.enum(['fine', 'small', 'medium', 'large', 'very_large']),
+  texture: z.enum(['smooth', 'slightly_rough', 'rough', 'very_rough']),
+});
+
+export const skinConditionEntrySchema = z.object({
+  type: z.enum([
+    'acne', 'rosacea', 'melasma', 'hyperpigmentation', 'hypopigmentation',
+    'eczema', 'psoriasis', 'sun_damage', 'scarring', 'keratosis',
+  ]),
+  severity: z.string().min(1),
+  location: z.string().optional(),
+  notes: z.string().optional(),
+});
+
+export const skinZoneAssessmentSchema = z.object({
+  zone: z.enum([
+    'forehead', 'periorbital', 'cheeks', 'nose', 'perioral', 'chin', 'neck', 'decolletage',
+  ]),
+  pigmentation: z.string().min(1),
+  texture: z.string().min(1),
+  vascularity: z.string().min(1),
+  photoaging: z.string().min(1),
+  notes: z.string().optional(),
+});
+
+export const skinQualityScalesSchema = z.object({
+  fitzpatrick: z.enum(['I', 'II', 'III', 'IV', 'V', 'VI']).optional(),
+  glogau: z.enum(['I', 'II', 'III', 'IV']).optional(),
+  elastosis: z.enum(['none', 'mild', 'moderate', 'severe']).optional(),
+});
+
+export const createSkinQualityAssessmentSchema = z.object({
+  patientId: z.string().min(1, 'Patient ID is required'),
+  appointmentId: z.string().optional(),
+  characteristics: skinCharacteristicsSchema.optional(),
+  conditions: z.array(skinConditionEntrySchema).optional(),
+  zoneAssessments: z.array(skinZoneAssessmentSchema).optional(),
+  scales: skinQualityScalesSchema.optional(),
+});
+
+export const updateSkinQualityAssessmentSchema = z.object({
+  appointmentId: z.string().optional(),
+  characteristics: skinCharacteristicsSchema.optional(),
+  conditions: z.array(skinConditionEntrySchema).optional(),
+  zoneAssessments: z.array(skinZoneAssessmentSchema).optional(),
+  scales: skinQualityScalesSchema.optional(),
+}).partial();
+
+export const skinQualityAssessmentSchema = z.object({
+  id: z.string(),
+  patientId: z.string(),
+  appointmentId: z.string().optional(),
+  characteristics: skinCharacteristicsSchema.optional(),
+  conditions: z.array(skinConditionEntrySchema),
+  zoneAssessments: z.array(skinZoneAssessmentSchema),
+  scales: skinQualityScalesSchema,
+  completionPercentage: z.number().min(0).max(100),
+  status: z.enum(['incomplete', 'ready_for_planning', 'treatment_planned']),
+  lastUpdatedBy: z.string(),
+  lastUpdatedByRole: z.enum(['PATIENT', 'PRACTITIONER']),
+  createdAt: z.any(),
+  updatedAt: z.any(),
+});