@blackcode_sa/metaestetics-api 1.5.28 → 1.5.30

package/dist/admin/index.d.mts

@@ -1,5 +1,982 @@
 import { Timestamp } from 'firebase/firestore';
 import * as admin from 'firebase-admin';
+import * as mailgun from 'mailgun-js';
+
+/**
+ * Enum for element types in documentation templates
+ */
+declare enum DocumentElementType {
+    HEADING = "heading",
+    PARAGRAPH = "paragraph",
+    LIST = "list",
+    DYNAMIC_TEXT = "dynamic_text",
+    BINARY_CHOICE = "binary_choice",
+    MULTIPLE_CHOICE = "multiple_choice",
+    SINGLE_CHOICE = "single_choice",
+    RATING_SCALE = "rating_scale",
+    TEXT_INPUT = "text_input",
+    DATE_PICKER = "date_picker",
+    SIGNATURE = "signature",
+    FILE_UPLOAD = "file_upload"
+}
+/**
+ * Enum for list types
+ */
+declare enum ListType {
+    ORDERED = "ordered",
+    UNORDERED = "unordered"
+}
+/**
+ * Enum for heading levels
+ */
+declare enum HeadingLevel {
+    H1 = "h1",
+    H2 = "h2",
+    H3 = "h3",
+    H4 = "h4",
+    H5 = "h5",
+    H6 = "h6"
+}
+/**
+ * Base interface for all document elements
+ */
+interface BaseDocumentElement {
+    id: string;
+    type: DocumentElementType;
+    required?: boolean;
+}
+/**
+ * Interface for heading element
+ */
+interface HeadingElement extends BaseDocumentElement {
+    type: DocumentElementType.HEADING;
+    text: string;
+    level: HeadingLevel;
+}
+/**
+ * Interface for paragraph element
+ */
+interface ParagraphElement extends BaseDocumentElement {
+    type: DocumentElementType.PARAGRAPH;
+    text: string;
+}
+/**
+ * Interface for list element
+ */
+interface ListElement extends BaseDocumentElement {
+    type: DocumentElementType.LIST;
+    items: string[];
+    listType: ListType;
+}
+/**
+ * Interface for dynamic text element
+ */
+interface DynamicTextElement extends BaseDocumentElement {
+    type: DocumentElementType.DYNAMIC_TEXT;
+    text: string;
+}
+/**
+ * Interface for binary choice element (Yes/No)
+ */
+interface BinaryChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.BINARY_CHOICE;
+    question: string;
+    defaultValue?: boolean;
+}
+/**
+ * Interface for multiple choice element
+ */
+interface MultipleChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.MULTIPLE_CHOICE;
+    question: string;
+    options: string[];
+    defaultValues?: string[];
+}
+/**
+ * Interface for single choice element
+ */
+interface SingleChoiceElement extends BaseDocumentElement {
+    type: DocumentElementType.SINGLE_CHOICE;
+    question: string;
+    options: string[];
+    defaultValue?: string;
+}
+/**
+ * Interface for rating scale element
+ */
+interface RatingScaleElement extends BaseDocumentElement {
+    type: DocumentElementType.RATING_SCALE;
+    question: string;
+    min: number;
+    max: number;
+    labels?: {
+        [key: number]: string;
+    };
+    defaultValue?: number;
+}
+/**
+ * Interface for text input element
+ */
+interface TextInputElement extends BaseDocumentElement {
+    type: DocumentElementType.TEXT_INPUT;
+    label: string;
+    placeholder?: string;
+    multiline?: boolean;
+    defaultValue?: string;
+}
+/**
+ * Interface for date picker element
+ */
+interface DatePickerElement extends BaseDocumentElement {
+    type: DocumentElementType.DATE_PICKER;
+    label: string;
+    defaultValue?: string;
+}
+/**
+ * Interface for signature element
+ */
+interface SignatureElement extends BaseDocumentElement {
+    type: DocumentElementType.SIGNATURE;
+    label: string;
+}
+/**
+ * Interface for file upload element
+ */
+interface FileUploadElement extends BaseDocumentElement {
+    type: DocumentElementType.FILE_UPLOAD;
+    label: string;
+    allowedFileTypes?: string[];
+    maxFileSizeMB?: number;
+}
+/**
+ * Union type for all document elements
+ */
+type DocumentElement = HeadingElement | ParagraphElement | ListElement | DynamicTextElement | BinaryChoiceElement | MultipleChoiceElement | SingleChoiceElement | RatingScaleElement | TextInputElement | DatePickerElement | SignatureElement | FileUploadElement;
+/**
+ * Interface for document template
+ */
+interface DocumentTemplate {
+    id: string;
+    title: string;
+    description?: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string;
+    elements: DocumentElement[];
+    tags?: string[];
+    version: number;
+    isActive: boolean;
+}
+
+/**
+ * Nivoi sertifikacije medicinskog osoblja, poređani od najnižeg do najvišeg
+ */
+declare enum CertificationLevel {
+    AESTHETICIAN = "aesthetician",// Osnovni estetičar
+    NURSE_ASSISTANT = "nurse_assistant",// Medicinski tehničar
+    NURSE = "nurse",// Medicinska sestra
+    NURSE_PRACTITIONER = "nurse_practitioner",// Viša medicinska sestra
+    PHYSICIAN_ASSISTANT = "physician_assistant",// Lekar asistent
+    DOCTOR = "doctor",// Doktor medicine
+    SPECIALIST = "specialist",// Specijalista
+    PLASTIC_SURGEON = "plastic_surgeon"
+}
+/**
+ * Dodatne specijalizacije potrebne za određene procedure
+ */
+declare enum CertificationSpecialty {
+    LASER = "laser",// Sertifikat za laserske tretmane
+    INJECTABLES = "injectables",// Sertifikat za injekcione tretmane
+    CHEMICAL_PEELS = "chemical_peels",// Sertifikat za hemijske pilinge
+    MICRODERMABRASION = "microdermabrasion",// Sertifikat za mikrodermoabraziju
+    BODY_CONTOURING = "body_contouring",// Sertifikat za konturiranje tela
+    SKIN_CARE = "skin_care",// Sertifikat za negu kože
+    WOUND_CARE = "wound_care",// Sertifikat za tretman rana
+    ANESTHESIA = "anesthesia"
+}
+/**
+ * Zahtevi sertifikacije za izvođenje procedura
+ */
+interface CertificationRequirement {
+    /** Minimalni nivo sertifikacije potreban za proceduru */
+    minimumLevel: CertificationLevel;
+    /** Dodatne specijalizacije potrebne za proceduru */
+    requiredSpecialties?: CertificationSpecialty[];
+}
+
+/**
+ * Condensed clinic review information
+ * @description Used for aggregated data attached to clinic documents
+ */
+interface ClinicReviewInfo {
+    totalReviews: number;
+    averageRating: number;
+    cleanliness: number;
+    facilities: number;
+    staffFriendliness: number;
+    waitingTime: number;
+    accessibility: number;
+    recommendationPercentage: number;
+}
+/**
+ * Condensed practitioner review information
+ * @description Used for aggregated data attached to practitioner documents
+ */
+interface PractitionerReviewInfo {
+    totalReviews: number;
+    averageRating: number;
+    knowledgeAndExpertise: number;
+    communicationSkills: number;
+    bedSideManner: number;
+    thoroughness: number;
+    trustworthiness: number;
+    recommendationPercentage: number;
+}
+/**
+ * Condensed procedure review information
+ * @description Used for aggregated data attached to procedure documents
+ */
+interface ProcedureReviewInfo {
+    totalReviews: number;
+    averageRating: number;
+    effectivenessOfTreatment: number;
+    outcomeExplanation: number;
+    painManagement: number;
+    followUpCare: number;
+    valueForMoney: number;
+    recommendationPercentage: number;
+}
+
+/**
+ * Familije procedura u sistemu
+ * Predstavlja najviši nivo hijerarhije i deli procedure na estetske i hirurške
+ *
+ * @enum
+ * @property AESTHETICS - Estetske procedure (neivazivne i minimalno invazivne)
+ * @property SURGERY - Hirurške procedure (invazivne)
+ */
+declare enum ProcedureFamily {
+    /** Estetske procedure koje ne zahtevaju hirurški zahvat */
+    AESTHETICS = "aesthetics",
+    /** Hirurške procedure koje zahtevaju operativni zahvat */
+    SURGERY = "surgery"
+}
+
+/**
+ * Kategorija procedura
+ * Kategorije su prvi nivo hijerarhije nakon procedure family
+ * One grupišu slične podkategorije u okviru familije procedura
+ *
+ * @property id - Jedinstveni identifikator kategorije
+ * @property name - Naziv kategorije
+ * @property description - Detaljan opis kategorije i njene namene
+ * @property family - Familija procedura kojoj kategorija pripada (aesthetics/surgery)
+ * @property isActive - Da li je kategorija aktivna u sistemu
+ * @property createdAt - Datum kreiranja
+ * @property updatedAt - Datum poslednjeg ažuriranja
+ */
+interface Category {
+    /** Jedinstveni identifikator kategorije (automatski generisan od strane Firestore) */
+    id?: string;
+    /** Naziv kategorije */
+    name: string;
+    /** Detaljan opis kategorije i njene namene */
+    description: string;
+    /** Tip procedure kojoj kategorija pripada */
+    family: ProcedureFamily;
+    /** Datum kreiranja kategorije */
+    createdAt: Date;
+    /** Datum poslednjeg ažuriranja kategorije */
+    updatedAt: Date;
+    /** Flag koji označava da li je kategorija aktivna */
+    isActive: boolean;
+}
+
+/**
+ * Podkategorija procedura
+ * Podkategorije su drugi nivo hijerarhije i pripadaju određenoj kategoriji
+ * One grupišu slične tehnologije u okviru kategorije
+ *
+ * @property id - Jedinstveni identifikator podkategorije
+ * @property name - Naziv podkategorije
+ * @property description - Detaljan opis podkategorije i njene namene
+ * @property categoryId - ID kategorije kojoj podkategorija pripada
+ * @property isActive - Da li je podkategorija aktivna u sistemu
+ * @property createdAt - Datum kreiranja
+ * @property updatedAt - Datum poslednjeg ažuriranja
+ */
+interface Subcategory {
+    /** Jedinstveni identifikator podkategorije (automatski generisan od strane Firestore) */
+    id?: string;
+    /** Naziv podkategorije */
+    name: string;
+    /** Detaljniji opis podkategorije */
+    description?: string;
+    /** ID kategorije kojoj podkategorija pripada */
+    categoryId: string;
+    /** Flag koji označava da li je podkategorija aktivna */
+    isActive: boolean;
+    /** Datum kreiranja podkategorije */
+    createdAt: Date;
+    /** Datum poslednjeg ažuriranja podkategorije */
+    updatedAt: Date;
+}
+
+/**
+ * Jedinica mere za vremenski period
+ */
+declare enum TimeUnit {
+    HOURS = "hours",
+    DAYS = "days"
+}
+/**
+ * Tip zahteva - da li se odnosi na period pre ili posle procedure
+ */
+declare enum RequirementType {
+    PRE = "pre",
+    POST = "post"
+}
+/**
+ * Nivo važnosti zahteva
+ */
+type RequirementImportance = "low" | "medium" | "high";
+/**
+ * Vremenski okvir za zahtev
+ * @property duration - Trajanje u odabranoj jedinici vremena
+ * @property unit - Jedinica vremena (sati ili dani)
+ * @property notifyAt - Lista trenutaka kada treba poslati obaveštenje (u istoj jedinici)
+ */
+interface TimeFrame {
+    duration: number;
+    unit: TimeUnit;
+    notifyAt: number[];
+}
+/**
+ * Zahtev koji se može povezati sa tehnologijom
+ * Može biti zahtev pre procedure (pre) ili posle procedure (post)
+ *
+ * @property id - Jedinstveni identifikator zahteva
+ * @property type - Tip zahteva (pre/post)
+ * @property name - Naziv zahteva
+ * @property description - Detaljan opis zahteva
+ * @property timeframe - Vremenski okvir za zahtev
+ * @property importance - Nivo važnosti zahteva
+ * @property isActive - Da li je zahtev aktivan u sistemu
+ * @property createdAt - Datum kreiranja
+ * @property updatedAt - Datum poslednjeg ažuriranja
+ */
+interface Requirement {
+    id: string;
+    type: RequirementType;
+    name: string;
+    description: string;
+    timeframe: TimeFrame;
+    importance: RequirementImportance;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+/**
+ * Blokirajući uslovi koji mogu sprečiti proceduru
+ * Ovi uslovi predstavljaju apsolutne kontraindikacije koje onemogućavaju izvođenje procedure
+ */
+declare enum BlockingCondition {
+    PREGNANCY = "pregnancy",
+    BREASTFEEDING = "breastfeeding",
+    ACTIVE_INFECTION = "active_infection",
+    SKIN_CONDITION = "skin_condition",
+    AUTOIMMUNE_DISEASE = "autoimmune_disease",
+    BLOOD_THINNERS = "blood_thinners",
+    RECENT_SURGERY = "recent_surgery",
+    DIABETES = "diabetes",
+    HEART_CONDITION = "heart_condition",
+    HIGH_BLOOD_PRESSURE = "high_blood_pressure",
+    KELOID_SCARRING = "keloid_scarring",
+    METAL_IMPLANTS = "metal_implants",
+    PACEMAKER = "pacemaker",
+    CANCER = "cancer",
+    EPILEPSY = "epilepsy"
+}
+
+/**
+ * Kontraindikacije koje mogu uticati na proceduru
+ * Ovi uslovi predstavljaju relativne kontraindikacije koje zahtevaju posebnu pažnju
+ */
+declare enum Contraindication {
+    SENSITIVE_SKIN = "sensitive_skin",
+    RECENT_TANNING = "recent_tanning",
+    RECENT_BOTOX = "recent_botox",
+    RECENT_FILLERS = "recent_fillers",
+    SKIN_ALLERGIES = "skin_allergies",
+    MEDICATIONS = "medications",
+    RECENT_CHEMICAL_PEEL = "recent_chemical_peel",
+    RECENT_LASER = "recent_laser",
+    SKIN_INFLAMMATION = "skin_inflammation",
+    OPEN_WOUNDS = "open_wounds",
+    HERPES_SIMPLEX = "herpes_simplex",
+    COLD_SORES = "cold_sores"
+}
+
+/**
+ * Benefiti koji se mogu očekivati od procedure
+ * Lista mogućih pozitivnih efekata i rezultata tretmana
+ */
+declare enum TreatmentBenefit {
+    WRINKLE_REDUCTION = "wrinkle_reduction",
+    SKIN_TIGHTENING = "skin_tightening",
+    COLLAGEN_PRODUCTION = "collagen_production",
+    ACNE_REDUCTION = "acne_reduction",
+    SCAR_REDUCTION = "scar_reduction",
+    PIGMENTATION_IMPROVEMENT = "pigmentation_improvement",
+    HAIR_REMOVAL = "hair_removal",
+    MUSCLE_TONING = "muscle_toning",
+    FAT_REDUCTION = "fat_reduction",
+    CELLULITE_REDUCTION = "cellulite_reduction",
+    SKIN_REJUVENATION = "skin_rejuvenation",
+    PORE_REDUCTION = "pore_reduction",
+    TEXTURE_IMPROVEMENT = "texture_improvement",
+    HYDRATION_BOOST = "hydration_boost",
+    CIRCULATION_IMPROVEMENT = "circulation_improvement"
+}
+
+/**
+ * Technology used in medical procedures
+ * Technologies are now a top-level collection that reference their full path in the hierarchy
+ * through family, category, and subcategory IDs
+ *
+ * @property id - Unique identifier of the technology
+ * @property name - Name of the technology
+ * @property description - Detailed description of the technology and its application
+ * @property family - The procedure family this technology belongs to (aesthetics/surgery)
+ * @property categoryId - ID of the category this technology belongs to
+ * @property subcategoryId - ID of the subcategory this technology belongs to
+ * @property technicalDetails - Technical specifications and details
+ * @property requirements - List of pre and post procedure requirements
+ * @property blockingConditions - List of conditions that prevent the procedure
+ * @property contraindications - List of conditions requiring special attention
+ * @property benefits - List of expected benefits from the procedure
+ * @property certificationRequirement - Required certification level and specialties
+ * @property documentationTemplates - List of documentation templates required for this technology
+ * @property isActive - Whether the technology is active in the system
+ * @property createdAt - Creation date
+ * @property updatedAt - Last update date
+ */
+interface Technology {
+    id?: string;
+    name: string;
+    description: string;
+    family: ProcedureFamily;
+    categoryId: string;
+    subcategoryId: string;
+    technicalDetails?: string;
+    requirements: {
+        pre: Requirement[];
+        post: Requirement[];
+    };
+    blockingConditions: BlockingCondition[];
+    contraindications: Contraindication[];
+    benefits: TreatmentBenefit[];
+    certificationRequirement: CertificationRequirement;
+    documentationTemplates?: DocumentTemplate[];
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+/**
+ * Product used in procedures
+ * Can be consumables, equipment, or any other product needed for performing procedures
+ *
+ * @property id - Unique identifier of the product
+ * @property name - Name of the product
+ * @property description - Detailed description of the product and its purpose
+ * @property brandId - ID of the brand that manufactures this product
+ * @property technologyId - ID of the technology this product is used with
+ * @property technicalDetails - Technical details and specifications
+ * @property warnings - List of warnings related to product use
+ * @property dosage - Dosage information (if applicable)
+ * @property composition - Product composition
+ * @property indications - List of indications for use
+ * @property contraindications - List of contraindications
+ * @property isActive - Whether the product is active in the system
+ * @property createdAt - Creation date
+ * @property updatedAt - Last update date
+ */
+interface Product {
+    id?: string;
+    name: string;
+    brandId: string;
+    technologyId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    isActive: boolean;
+    description?: string;
+    technicalDetails?: string;
+    warnings?: string[];
+    dosage?: string;
+    composition?: string;
+    indications?: string[];
+    contraindications?: string[];
+}
+
+declare enum PricingMeasure {
+    PER_ML = "per_ml",
+    PER_ZONE = "per_zone",
+    PER_AREA = "per_area",
+    PER_SESSION = "per_session",
+    PER_TREATMENT = "per_treatment",
+    PER_PACKAGE = "per_package"
+}
+declare enum Currency {
+    EUR = "EUR",
+    USD = "USD",
+    GBP = "GBP",
+    CHF = "CHF",
+    AUD = "AUD"
+}
+
+/**
+ * Procedure represents a specific medical procedure that can be performed by a practitioner in a clinic
+ * It inherits properties from technology and adds clinic/practitioner specific details
+ */
+interface Procedure {
+    /** Unique identifier of the procedure */
+    id: string;
+    /** Name of the procedure */
+    name: string;
+    /** Detailed description of the procedure */
+    description: string;
+    /** Family of procedures this belongs to (aesthetics/surgery) */
+    family: ProcedureFamily;
+    /** Category this procedure belongs to */
+    category: Category;
+    /** Subcategory this procedure belongs to */
+    subcategory: Subcategory;
+    /** Technology used in this procedure */
+    technology: Technology;
+    /** Product used in this procedure */
+    product: Product;
+    /** Price of the procedure */
+    price: number;
+    /** Currency for the price */
+    currency: Currency;
+    /** How the price is measured (per ml, per zone, etc.) */
+    pricingMeasure: PricingMeasure;
+    /** Duration of the procedure in minutes */
+    duration: number;
+    /** Blocking conditions that prevent this procedure */
+    blockingConditions: BlockingCondition[];
+    /** Treatment benefits of this procedure */
+    treatmentBenefits: TreatmentBenefit[];
+    /** Pre-procedure requirements */
+    preRequirements: Requirement[];
+    /** Post-procedure requirements */
+    postRequirements: Requirement[];
+    /** Certification requirements for performing this procedure */
+    certificationRequirement: CertificationRequirement;
+    /** Documentation templates required for this procedure */
+    documentationTemplates: DocumentTemplate[];
+    /** ID of the practitioner who performs this procedure */
+    practitionerId: string;
+    /** ID of the clinic branch where this procedure is performed */
+    clinicBranchId: string;
+    /** Aggregated clinic information */
+    clinicInfo: ClinicInfo;
+    /** Aggregated doctor information */
+    doctorInfo: DoctorInfo;
+    /** Aggregated review information for this procedure */
+    reviewInfo: ProcedureReviewInfo;
+    /** Whether this procedure is active */
+    isActive: boolean;
+    /** When this procedure was created */
+    createdAt: Date;
+    /** When this procedure was last updated */
+    updatedAt: Date;
+}
+/**
+ * Aggregated summary information for a procedure.
+ * Used in arrays within Clinic and Practitioner documents for quick display.
+ */
+interface ProcedureSummaryInfo {
+    id: string;
+    name: string;
+    description?: string;
+    photo?: string;
+    family: ProcedureFamily;
+    categoryName: string;
+    subcategoryName: string;
+    technologyName: string;
+    price: number;
+    pricingMeasure: PricingMeasure;
+    currency: Currency;
+    duration: number;
+    clinicId: string;
+    clinicName: string;
+    practitionerId: string;
+    practitionerName: string;
+}
+
+/**
+ * Osnovne informacije o zdravstvenom radniku
+ */
+interface PractitionerBasicInfo {
+    firstName: string;
+    lastName: string;
+    title: string;
+    email: string;
+    phoneNumber: string;
+    dateOfBirth: Timestamp | Date;
+    gender: "male" | "female" | "other";
+    profileImageUrl?: string;
+    bio?: string;
+    languages: string[];
+}
+/**
+ * Sertifikacija zdravstvenog radnika
+ */
+interface PractitionerCertification {
+    level: CertificationLevel;
+    specialties: CertificationSpecialty[];
+    licenseNumber: string;
+    issuingAuthority: string;
+    issueDate: Timestamp | Date;
+    expiryDate?: Timestamp | Date;
+    verificationStatus: "pending" | "verified" | "rejected";
+}
+/**
+ * Interfejs za radno vreme zdravstvenog radnika u klinici
+ */
+interface PractitionerClinicWorkingHours {
+    clinicId: string;
+    workingHours: {
+        monday: {
+            start: string;
+            end: string;
+        } | null;
+        tuesday: {
+            start: string;
+            end: string;
+        } | null;
+        wednesday: {
+            start: string;
+            end: string;
+        } | null;
+        thursday: {
+            start: string;
+            end: string;
+        } | null;
+        friday: {
+            start: string;
+            end: string;
+        } | null;
+        saturday: {
+            start: string;
+            end: string;
+        } | null;
+        sunday: {
+            start: string;
+            end: string;
+        } | null;
+    };
+    isActive: boolean;
+    createdAt: Timestamp | Date;
+    updatedAt: Timestamp | Date;
+}
+/**
+ * Status of practitioner profile
+ */
+declare enum PractitionerStatus {
+    DRAFT = "draft",
+    ACTIVE = "active"
+}
+/**
+ * Token status for practitioner invitations
+ */
+declare enum PractitionerTokenStatus {
+    ACTIVE = "active",
+    USED = "used",
+    EXPIRED = "expired",
+    REVOKED = "revoked"
+}
+/**
+ * Interfejs za zdravstvenog radnika
+ */
+interface Practitioner {
+    id: string;
+    userRef: string;
+    basicInfo: PractitionerBasicInfo;
+    certification: PractitionerCertification;
+    clinics: string[];
+    clinicWorkingHours: PractitionerClinicWorkingHours[];
+    clinicsInfo: ClinicInfo[];
+    procedures: string[];
+    proceduresInfo: ProcedureSummaryInfo[];
+    reviewInfo: PractitionerReviewInfo;
+    isActive: boolean;
+    isVerified: boolean;
+    status: PractitionerStatus;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+}
+/**
+ * Token za pozivanje zdravstvenog radnika
+ */
+interface PractitionerToken {
+    id: string;
+    token: string;
+    practitionerId: string;
+    email: string;
+    clinicId: string;
+    status: PractitionerTokenStatus;
+    createdBy: string;
+    createdAt: Timestamp;
+    expiresAt: Timestamp;
+    usedBy?: string;
+    usedAt?: Timestamp;
+}
+
+/**
+ * Interfejs za gamifikaciju
+ */
+interface GamificationInfo {
+    /** Nivo korisnika */
+    level: number;
+    /** Trenutni poeni */
+    points: number;
+}
+/**
+ * Interfejs za doktora pacijenta
+ */
+interface PatientDoctor {
+    userRef: string;
+    assignedAt: Timestamp;
+    assignedBy?: string;
+    isActive: boolean;
+    notes?: string;
+}
+/**
+ * Interfejs za kliniku pacijenta
+ */
+interface PatientClinic {
+    clinicId: string;
+    assignedAt: Timestamp;
+    assignedBy?: string;
+    isActive: boolean;
+    notes?: string;
+}
+/**
+ * Glavni interfejs za Patient profil (top-level kolekcija)
+ */
+interface PatientProfile {
+    id: string;
+    userRef: string;
+    displayName: string;
+    profilePhoto: string | null;
+    gamification: GamificationInfo;
+    expoTokens: string[];
+    isActive: boolean;
+    isVerified: boolean;
+    phoneNumber?: string | null;
+    dateOfBirth?: Timestamp | null;
+    doctors: PatientDoctor[];
+    clinics: PatientClinic[];
+    doctorIds: string[];
+    clinicIds: string[];
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+}
+
+/**
+ * Interface for clinic profile information
+ */
+interface ClinicInfo {
+    id: string;
+    featuredPhoto: string;
+    name: string;
+    description?: string | null;
+    location: ClinicLocation;
+    contactInfo: ClinicContactInfo;
+}
+
+/**
+ * Enum for all possible clinic tags
+ */
+declare enum ClinicTag {
+    PARKING = "parking",
+    WIFI = "wifi",
+    WHEELCHAIR_ACCESS = "wheelchair_access",
+    CAFE = "cafe",
+    PHARMACY = "pharmacy",
+    WAITING_ROOM = "waiting_room",
+    CARD_PAYMENT = "card_payment",
+    INSURANCE = "insurance",
+    CHILDREN_AREA = "children_area",
+    TV = "tv",
+    AIR_CONDITIONING = "air_conditioning",
+    WATER_DISPENSER = "water_dispenser",
+    VENDING_MACHINE = "vending_machine",
+    ELEVATOR = "elevator",
+    RAMP = "ramp",
+    HANDICAP_PARKING = "handicap_parking",
+    BRAILLE = "braille",
+    SIGN_LANGUAGE = "sign_language",
+    EMERGENCY_SERVICE = "emergency_service",
+    LAB = "lab",
+    XRAY = "xray",
+    ULTRASOUND = "ultrasound",
+    DENTAL = "dental",
+    PEDIATRIC = "pediatric",
+    GYNECOLOGY = "gynecology",
+    CARDIOLOGY = "cardiology",
+    DERMATOLOGY = "dermatology",
+    ORTHOPEDIC = "orthopedic",
+    OPHTHALMOLOGY = "ophthalmology",
+    TELEMEDICINE = "telemedicine",
+    HOME_VISITS = "home_visits",
+    ONLINE_BOOKING = "online_booking",
+    MOBILE_APP = "mobile_app",
+    SMS_NOTIFICATIONS = "sms_notifications",
+    EMAIL_NOTIFICATIONS = "email_notifications",
+    ENGLISH = "english",
+    SERBIAN = "serbian",
+    GERMAN = "german",
+    RUSSIAN = "russian",
+    CHINESE = "chinese",
+    SPANISH = "spanish",
+    FRENCH = "french",
+    OPEN_24_7 = "open_24_7",
+    WEEKEND_HOURS = "weekend_hours",
+    NIGHT_SHIFT = "night_shift",
+    HOLIDAY_HOURS = "holiday_hours"
+}
+
+/**
+ * Interface for clinic contact information
+ */
+interface ClinicContactInfo {
+    email: string;
+    phoneNumber: string;
+    alternativePhoneNumber?: string | null;
+    website?: string | null;
+}
+/**
+ * Interface for clinic location
+ */
+interface ClinicLocation {
+    address: string;
+    city: string;
+    country: string;
+    postalCode: string;
+    latitude: number;
+    longitude: number;
+    geohash?: string | null;
+}
+/**
+ * Interface for working hours
+ */
+interface WorkingHours {
+    monday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    tuesday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    wednesday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    thursday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    friday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    saturday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+    sunday: {
+        open: string;
+        close: string;
+        breaks?: {
+            start: string;
+            end: string;
+        }[];
+    } | null;
+}
+/**
+ * Interface for doctor information
+ */
+interface DoctorInfo {
+    id: string;
+    name: string;
+    description?: string;
+    photo: string;
+    rating: number;
+    services: string[];
+}
+/**
+ * Interface for service information
+ */
+/**
+ * Interface for clinic
+ */
+interface Clinic {
+    id: string;
+    clinicGroupId: string;
+    name: string;
+    description?: string;
+    location: ClinicLocation;
+    contactInfo: ClinicContactInfo;
+    workingHours: WorkingHours;
+    tags: ClinicTag[];
+    featuredPhotos: string[];
+    coverPhoto: string | null;
+    photosWithTags?: {
+        url: string;
+        tag: string;
+    }[];
+    doctors: string[];
+    doctorsInfo: DoctorInfo[];
+    procedures: string[];
+    proceduresInfo: ProcedureSummaryInfo[];
+    reviewInfo: ClinicReviewInfo;
+    admins: string[];
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    isActive: boolean;
+    isVerified: boolean;
+    logo?: string;
+}
 
 declare enum UserRole {
     PATIENT = "patient",
@@ -152,4 +1129,350 @@ declare class NotificationsAdmin {
     cleanupOldNotifications(daysOld?: number, batchSize?: number): Promise<void>;
 }
 
-export { type AppointmentNotification, type AppointmentReminderNotification, type BaseNotification, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type PostRequirementNotification, type PreRequirementNotification, UserRole };
+/**
+ * @class ClinicAggregationService
+ * @description Handles aggregation tasks related to clinic data updates.
+ * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
+ * triggered by changes in the clinics collection.
+ */
+declare class ClinicAggregationService {
+    private db;
+    /**
+     * Constructor for ClinicAggregationService.
+     * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
+     */
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Adds clinic information to a clinic group when a new clinic is created
+     * @param clinicGroupId - ID of the parent clinic group
+     * @param clinicInfo - The clinic information to add to the group
+     * @returns {Promise<void>}
+     * @throws Will throw an error if the batch write fails
+     */
+    addClinicToClinicGroup(clinicGroupId: string, clinicInfo: ClinicInfo): Promise<void>;
+    /**
+     * Updates the ClinicInfo within the clinicsInfo array for multiple practitioners.
+     * This method is designed to be called when a clinic's core information changes.
+     * @param practitionerIds - IDs of practitioners associated with the clinic.
+     * @param clinicInfo - The updated ClinicInfo object to aggregate.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if the batch write fails.
+     */
+    updateClinicInfoInPractitioners(practitionerIds: string[], clinicInfo: ClinicInfo): Promise<void>;
+    /**
+     * Updates the aggregated clinicInfo field within relevant Procedure documents.
+     * @param procedureIds IDs of procedures performed at the clinic.
+     * @param clinicInfo The updated ClinicInfo object.
+     */
+    updateClinicInfoInProcedures(procedureIds: string[], clinicInfo: ClinicInfo): Promise<void>;
+    /**
+     * Updates the aggregated clinicsInfo array within the parent ClinicGroup document.
+     * @param clinicGroupId The ID of the parent clinic group.
+     * @param clinicInfo The updated ClinicInfo object.
+     */
+    updateClinicInfoInClinicGroup(clinicGroupId: string, clinicInfo: ClinicInfo): Promise<void>;
+    /**
+     * Updates relevant clinic information within Patient documents.
+     * NOTE: PatientProfile stores an array of PatientClinic objects, which only contain
+     * clinicId, assignedAt, assignedBy, isActive, notes. It does *not* store aggregated
+     * ClinicInfo (like name, photo). Therefore, this method currently has limited use
+     * for general clinic info updates. It might be relevant if Clinic.isActive status changes.
+     *
+     * @param patientIds IDs of patients associated with the clinic (e.g., from PatientProfile.clinicIds).
+     * @param clinicInfo The updated ClinicInfo object (primarily for logging/context).
+     * @param clinicIsActive The current active status of the updated clinic.
+     */
+    updateClinicInfoInPatients(patientIds: string[], clinicInfo: ClinicInfo, clinicIsActive: boolean): Promise<void>;
+    /**
+     * Updates the eventLocation for upcoming calendar events associated with a specific clinic.
+     * Uses a collection group query to find relevant events across all potential parent collections.
+     *
+     * @param clinicId The ID of the clinic whose location might have changed.
+     * @param newLocation The new ClinicLocation object.
+     */
+    updateClinicLocationInCalendarEvents(clinicId: string, newLocation: ClinicLocation): Promise<void>;
+    /**
+     * Updates clinic info in all upcoming calendar events associated with a specific clinic.
+     * @param clinicId The ID of the clinic whose info has been updated.
+     * @param clinicInfo The updated ClinicInfo object.
+     */
+    updateClinicInfoInCalendarEvents(clinicId: string, clinicInfo: ClinicInfo): Promise<void>;
+    /**
+     * Removes clinic from practitioners when a clinic is deleted.
+     * @param practitionerIds IDs of practitioners associated with the clinic.
+     * @param clinicId The ID of the deleted clinic.
+     */
+    removeClinicFromPractitioners(practitionerIds: string[], clinicId: string): Promise<void>;
+    /**
+     * Inactivates all procedures associated with a deleted clinic
+     * @param procedureIds IDs of procedures associated with the clinic
+     */
+    inactivateProceduresForClinic(procedureIds: string[]): Promise<void>;
+    /**
+     * Removes clinic from clinic group when a clinic is deleted
+     * @param clinicGroupId ID of the parent clinic group
+     * @param clinicId ID of the deleted clinic
+     */
+    removeClinicFromClinicGroup(clinicGroupId: string, clinicId: string): Promise<void>;
+    /**
+     * Removes clinic from patients when a clinic is deleted
+     * @param patientIds IDs of patients associated with the clinic
+     * @param clinicId ID of the deleted clinic
+     */
+    removeClinicFromPatients(patientIds: string[], clinicId: string): Promise<void>;
+    /**
+     * Cancels all upcoming calendar events associated with a deleted clinic
+     * @param clinicId ID of the deleted clinic
+     */
+    cancelUpcomingCalendarEventsForClinic(clinicId: string): Promise<void>;
+}
+
+/**
+ * @class PractitionerAggregationService
+ * @description Handles aggregation tasks related to practitioner data updates/deletions.
+ */
+declare class PractitionerAggregationService {
+    private db;
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Adds practitioner information to a clinic when a new practitioner is created
+     * @param clinicId - ID of the clinic to update
+     * @param doctorInfo - Doctor information to add to the clinic
+     * @returns {Promise<void>}
+     */
+    addPractitionerToClinic(clinicId: string, doctorInfo: DoctorInfo): Promise<void>;
+    /**
+     * Updates practitioner information in associated clinics
+     * @param clinicIds - IDs of clinics associated with the practitioner
+     * @param doctorInfo - Updated doctor information
+     * @returns {Promise<void>}
+     */
+    updatePractitionerInfoInClinics(clinicIds: string[], doctorInfo: DoctorInfo): Promise<void>;
+    /**
+     * Updates practitioner information in associated procedures
+     * @param procedureIds - IDs of procedures associated with the practitioner
+     * @param doctorInfo - Updated doctor information
+     * @returns {Promise<void>}
+     */
+    updatePractitionerInfoInProcedures(procedureIds: string[], doctorInfo: DoctorInfo): Promise<void>;
+    /**
+     * Updates practitioner information in calendar events
+     * @param practitionerId - ID of the practitioner
+     * @param practitionerInfo - Updated practitioner information
+     * @returns {Promise<void>}
+     */
+    updatePractitionerInfoInCalendarEvents(practitionerId: string, practitionerInfo: DoctorInfo): Promise<void>;
+    /**
+     * Removes practitioner from clinics when a practitioner is deleted
+     * @param clinicIds - IDs of clinics associated with the practitioner
+     * @param practitionerId - ID of the deleted practitioner
+     * @returns {Promise<void>}
+     */
+    removePractitionerFromClinics(clinicIds: string[], practitionerId: string): Promise<void>;
+    /**
+     * Cancels all upcoming calendar events for a deleted practitioner
+     * @param practitionerId - ID of the deleted practitioner
+     * @returns {Promise<void>}
+     */
+    cancelUpcomingCalendarEventsForPractitioner(practitionerId: string): Promise<void>;
+    /**
+     * Removes practitioner from patients when a practitioner is deleted
+     * @param patientIds - IDs of patients associated with the practitioner
+     * @param practitionerId - ID of the deleted practitioner
+     * @returns {Promise<void>}
+     */
+    removePractitionerFromPatients(patientIds: string[], practitionerId: string): Promise<void>;
+    /**
+     * Inactivates all procedures associated with a deleted practitioner
+     * @param procedureIds - IDs of procedures provided by the practitioner
+     * @returns {Promise<void>}
+     */
+    inactivateProceduresForPractitioner(procedureIds: string[]): Promise<void>;
+}
+
+/**
+ * @class ProcedureAggregationService
+ * @description Handles aggregation tasks related to procedure data updates/deletions.
+ */
+declare class ProcedureAggregationService {
+    private db;
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Adds procedure information to a practitioner when a new procedure is created
+     * @param practitionerId - ID of the practitioner who performs the procedure
+     * @param procedureSummary - Summary information about the procedure
+     * @returns {Promise<void>}
+     */
+    addProcedureToPractitioner(practitionerId: string, procedureSummary: ProcedureSummaryInfo): Promise<void>;
+    /**
+     * Adds procedure information to a clinic when a new procedure is created
+     * @param clinicId - ID of the clinic where the procedure is performed
+     * @param procedureSummary - Summary information about the procedure
+     * @returns {Promise<void>}
+     */
+    addProcedureToClinic(clinicId: string, procedureSummary: ProcedureSummaryInfo): Promise<void>;
+    /**
+     * Updates procedure information in a practitioner document
+     * @param practitionerId - ID of the practitioner who performs the procedure
+     * @param procedureSummary - Updated summary information about the procedure
+     * @returns {Promise<void>}
+     */
+    updateProcedureInfoInPractitioner(practitionerId: string, procedureSummary: ProcedureSummaryInfo): Promise<void>;
+    /**
+     * Updates procedure information in a clinic document
+     * @param clinicId - ID of the clinic where the procedure is performed
+     * @param procedureSummary - Updated summary information about the procedure
+     * @returns {Promise<void>}
+     */
+    updateProcedureInfoInClinic(clinicId: string, procedureSummary: ProcedureSummaryInfo): Promise<void>;
+    /**
+     * Updates procedure information in calendar events
+     * @param procedureId - ID of the procedure
+     * @param procedureInfo - Updated procedure information
+     * @returns {Promise<void>}
+     */
+    updateProcedureInfoInCalendarEvents(procedureId: string, procedureInfo: any): Promise<void>;
+    /**
+     * Cancels all upcoming calendar events for a procedure
+     * @param procedureId - ID of the procedure
+     * @returns {Promise<void>}
+     */
+    cancelUpcomingCalendarEventsForProcedure(procedureId: string): Promise<void>;
+    /**
+     * Removes procedure from a practitioner when a procedure is deleted or inactivated
+     * @param practitionerId - ID of the practitioner who performs the procedure
+     * @param procedureId - ID of the procedure
+     * @returns {Promise<void>}
+     */
+    removeProcedureFromPractitioner(practitionerId: string, procedureId: string): Promise<void>;
+    /**
+     * Removes procedure from a clinic when a procedure is deleted or inactivated
+     * @param clinicId - ID of the clinic where the procedure is performed
+     * @param procedureId - ID of the procedure
+     * @returns {Promise<void>}
+     */
+    removeProcedureFromClinic(clinicId: string, procedureId: string): Promise<void>;
+}
+
+/**
+ * @class PatientAggregationService
+ * @description Handles aggregation tasks related to patient data updates/deletions.
+ */
+declare class PatientAggregationService {
+    private db;
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Updates patient information in calendar events
+     * @param patientId - ID of the patient
+     * @param patientInfo - Updated patient information
+     * @returns {Promise<void>}
+     */
+    updatePatientInfoInCalendarEvents(patientId: string, patientInfo: any): Promise<void>;
+    /**
+     * Cancels all upcoming calendar events associated with a deleted patient
+     * @param patientId - ID of the deleted patient
+     * @returns {Promise<void>}
+     */
+    cancelUpcomingCalendarEventsForPatient(patientId: string): Promise<void>;
+}
+
+/**
+ * Base mailing service class that provides common functionality for all mailing services
+ */
+declare class BaseMailingService {
+    protected db: FirebaseFirestore.Firestore;
+    protected mailgunClient: mailgun.Mailgun;
+    /**
+     * Constructor for BaseMailingService
+     * @param firestore Firestore instance provided by the caller
+     * @param mailgunClient Mailgun client instance provided by the caller
+     */
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    /**
+     * Sends an email using Mailgun
+     * @param data Email data to send, including the 'from' address
+     * @returns Promise with the sending result
+     */
+    protected sendEmail(data: mailgun.messages.SendData): Promise<mailgun.messages.SendResponse>;
+    /**
+     * Logs email sending attempt to Firestore for tracking
+     * @param emailData Email data that was sent
+     * @param success Whether the email was sent successfully
+     * @param error Error object if the email failed to send
+     */
+    protected logEmailAttempt(emailData: {
+        to: string;
+        subject: string;
+        templateName?: string;
+    }, success: boolean, error?: any): Promise<void>;
+    /**
+     * Renders a simple HTML email template with variables
+     * @param template HTML template string
+     * @param variables Key-value pairs to replace in the template
+     * @returns Rendered HTML string
+     */
+    protected renderTemplate(template: string, variables: Record<string, string>): string;
+}
+
+/**
+ * Interface for the data required to send a practitioner invitation email
+ */
+interface PractitionerInviteEmailData {
+    /** The token object from the practitioner service */
+    token: {
+        id: string;
+        token: string;
+        practitionerId: string;
+        email: string;
+        clinicId: string;
+        expiresAt: admin.firestore.Timestamp;
+    };
+    /** Practitioner basic info */
+    practitioner: {
+        firstName: string;
+        lastName: string;
+    };
+    /** Clinic info */
+    clinic: {
+        name: string;
+        contactEmail: string;
+        contactName?: string;
+    };
+    /** Config options */
+    options?: {
+        registrationUrl?: string;
+        customSubject?: string;
+        fromAddress?: string;
+    };
+}
+/**
+ * Service for sending practitioner invitation emails
+ */
+declare class PractitionerInviteMailingService extends BaseMailingService {
+    private readonly DEFAULT_REGISTRATION_URL;
+    private readonly DEFAULT_SUBJECT;
+    private readonly DEFAULT_FROM_ADDRESS;
+    /**
+     * Constructor for PractitionerInviteMailingService
+     * @param firestore Firestore instance provided by the caller
+     * @param mailgunClient Mailgun client instance provided by the caller
+     */
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    /**
+     * Sends a practitioner invitation email
+     * @param data The practitioner invitation data
+     * @returns Promise resolved when email is sent
+     */
+    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<mailgun.messages.SendResponse>;
+    /**
+     * Handles the practitioner token creation event from Cloud Functions
+     * Fetches necessary data using defined types and collection constants,
+     * and sends the invitation email.
+     * @param tokenData The fully typed token object including its id
+     * @param fromAddress The 'from' email address to use, obtained from config
+     * @returns Promise resolved when the email is sent
+     */
+    handleTokenCreationEvent(tokenData: PractitionerToken, fromAddress: string): Promise<void>;
+}
+
+export { type AppointmentNotification, type AppointmentReminderNotification, BaseMailingService, type BaseNotification, type Clinic, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type DoctorInfo, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type PatientProfile as Patient, PatientAggregationService, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, PractitionerInviteMailingService, type PractitionerToken, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureSummaryInfo, UserRole };