@blackcode_sa/metaestetics-api 1.8.0 → 1.8.2

package/dist/admin/index.d.mts

@@ -1,6 +1,6 @@
-import { Timestamp, FieldValue } from 'firebase/firestore';
-import * as admin from 'firebase-admin';
+import { Timestamp } from 'firebase/firestore';
 import { Timestamp as Timestamp$1 } from 'firebase-admin/firestore';
+import * as admin from 'firebase-admin';
 
 declare enum UserRole {
     PATIENT = "patient",
@@ -8,6 +8,18 @@ declare enum UserRole {
     APP_ADMIN = "app_admin",
     CLINIC_ADMIN = "clinic_admin"
 }
+interface User {
+    uid: string;
+    email: string | null;
+    roles: UserRole[];
+    isAnonymous: boolean;
+    createdAt: any;
+    updatedAt: any;
+    lastLoginAt: any;
+    patientProfile?: string;
+    practitionerProfile?: string;
+    adminProfile?: string;
+}
 
 /**
  * Review system type definitions
@@ -922,6 +934,101 @@ interface PractitionerToken {
     emailErrorAt?: Timestamp;
 }
 
+declare enum AllergyType {
+    MEDICATION = "medication",
+    FOOD = "food",
+    ENVIRONMENTAL = "environmental",
+    LATEX = "latex",
+    COSMETIC = "cosmetic",
+    OTHER = "other"
+}
+declare enum MedicationAllergySubtype {
+    ANTIBIOTICS = "antibiotics",
+    NSAIDS = "nsaids",
+    OPIOIDS = "opioids",
+    ANESTHETICS = "anesthetics",
+    VACCINES = "vaccines",
+    OTHER = "other"
+}
+declare enum FoodAllergySubtype {
+    NUTS = "nuts",
+    SHELLFISH = "shellfish",
+    DAIRY = "dairy",
+    EGGS = "eggs",
+    WHEAT = "wheat",
+    SOY = "soy",
+    FISH = "fish",
+    FRUITS = "fruits",
+    OTHER = "other"
+}
+declare enum EnvironmentalAllergySubtype {
+    POLLEN = "pollen",
+    DUST = "dust",
+    MOLD = "mold",
+    PET_DANDER = "pet_dander",
+    INSECTS = "insects",
+    OTHER = "other"
+}
+declare enum CosmeticAllergySubtype {
+    FRAGRANCES = "fragrances",
+    PRESERVATIVES = "preservatives",
+    DYES = "dyes",
+    METALS = "metals",
+    OTHER = "other"
+}
+type AllergySubtype = MedicationAllergySubtype | FoodAllergySubtype | EnvironmentalAllergySubtype | CosmeticAllergySubtype | "other";
+
+interface Allergy {
+    type: AllergyType;
+    subtype: AllergySubtype;
+    name?: string | null;
+    severity?: "mild" | "moderate" | "severe" | null;
+    reaction?: string | null;
+    diagnosed?: Timestamp | null;
+    notes?: string | null;
+}
+interface VitalStats {
+    height?: number;
+    weight?: number;
+    bloodType?: "A+" | "A-" | "B+" | "B-" | "AB+" | "AB-" | "O+" | "O-";
+    bloodPressure?: {
+        systolic: number;
+        diastolic: number;
+        lastMeasured: Timestamp;
+    };
+}
+interface PatientMedicalInfo {
+    patientId: string;
+    vitalStats: VitalStats;
+    blockingConditions: {
+        condition: BlockingCondition;
+        diagnosedAt: Timestamp;
+        isActive: boolean;
+        notes?: string | null;
+    }[];
+    contraindications: {
+        condition: Contraindication;
+        lastOccurrence: Timestamp;
+        frequency: "rare" | "occasional" | "frequent";
+        isActive: boolean;
+        notes?: string | null;
+    }[];
+    allergies: Allergy[];
+    currentMedications: {
+        name: string;
+        dosage: string;
+        frequency: string;
+        startDate?: Timestamp | null;
+        endDate?: Timestamp | null;
+        prescribedBy?: string | null;
+    }[];
+    emergencyNotes?: string;
+    lastUpdated: Timestamp;
+    updatedBy: string;
+    verifiedBy?: string;
+    verifiedAt?: Timestamp;
+}
+
 declare const PATIENTS_COLLECTION = "patients";
 declare const PATIENT_SENSITIVE_INFO_COLLECTION = "sensitive-info";
 /**
@@ -981,6 +1088,23 @@ interface PatientSensitiveInfo {
     createdAt: Timestamp;
     updatedAt: Timestamp;
 }
+/**
+ * Tip za kreiranje osetljivih informacija
+ */
+interface CreatePatientSensitiveInfoData {
+    patientId: string;
+    userRef?: string;
+    photoUrl?: MediaResource | null;
+    firstName: string;
+    lastName: string;
+    dateOfBirth: Timestamp | null;
+    gender: Gender;
+    email?: string;
+    phoneNumber?: string;
+    alternativePhoneNumber?: string;
+    addressData?: AddressData;
+    emergencyContacts?: EmergencyContact[];
+}
 /**
  * Interfejs za doktora pacijenta
  */
@@ -1022,6 +1146,22 @@ interface PatientProfile {
     createdAt: Timestamp;
     updatedAt: Timestamp;
 }
+/**
+ * Tip za kreiranje novog Patient profila
+ */
+interface CreatePatientProfileData {
+    userRef?: string;
+    displayName: string;
+    expoTokens: string[];
+    gamification?: GamificationInfo;
+    isActive: boolean;
+    isVerified: boolean;
+    isManual: boolean;
+    doctors?: PatientDoctor[];
+    clinics?: PatientClinic[];
+    doctorIds?: string[];
+    clinicIds?: string[];
+}
 
 /**
  * Interface for clinic profile information
@@ -1507,90 +1647,6 @@ interface Appointment {
     /** NEW: Metadata for the appointment - used for area selection and photos */
     metadata?: AppointmentMetadata;
 }
-/**
- * Data needed to create a new Appointment
- */
-interface CreateAppointmentData {
-    clinicBranchId: string;
-    practitionerId: string;
-    patientId: string;
-    procedureId: string;
-    appointmentStartTime: Timestamp;
-    appointmentEndTime: Timestamp;
-    cost: number;
-    currency: Currency;
-    patientNotes?: string | null;
-    initialStatus: AppointmentStatus;
-    initialPaymentStatus?: PaymentStatus;
-}
-/**
- * Data needed to create a new Appointment via CreateAppointmentHttp method
- */
-interface CreateAppointmentHttpData {
-    patientId: string;
-    procedureId: string;
-    appointmentStartTime: Timestamp;
-    appointmentEndTime: Timestamp;
-    patientNotes?: string | null;
-}
-/**
- * Data allowed for updating an Appointment
- */
-interface UpdateAppointmentData {
-    status?: AppointmentStatus;
-    confirmationTime?: Timestamp | FieldValue | null;
-    cancellationTime?: Timestamp | FieldValue | null;
-    rescheduleTime?: Timestamp | FieldValue | null;
-    procedureActualStartTime?: Timestamp | FieldValue | null;
-    actualDurationMinutes?: number;
-    cancellationReason?: string | null;
-    canceledBy?: "patient" | "clinic" | "practitioner" | "system";
-    internalNotes?: string | null;
-    patientNotes?: string | FieldValue | null;
-    paymentStatus?: PaymentStatus;
-    paymentTransactionId?: string | FieldValue | null;
-    completedPreRequirements?: string[] | FieldValue;
-    completedPostRequirements?: string[] | FieldValue;
-    appointmentStartTime?: Timestamp;
-    appointmentEndTime?: Timestamp;
-    calendarEventId?: string;
-    cost?: number;
-    clinicBranchId?: string;
-    practitionerId?: string;
-    /** NEW: For updating linked forms - typically managed by dedicated methods */
-    linkedFormIds?: string[] | FieldValue;
-    linkedForms?: LinkedFormInfo[] | FieldValue;
-    /** NEW: For updating media items - typically managed by dedicated methods */
-    media?: AppointmentMediaItem[] | FieldValue;
-    /** NEW: For adding/updating review information */
-    reviewInfo?: PatientReviewInfo | FieldValue | null;
-    /** NEW: For setting practitioner finalization details */
-    finalizedDetails?: {
-        by: string;
-        at: Timestamp;
-        notes?: string;
-    } | FieldValue;
-    /** NEW: For archiving/unarchiving */
-    isArchived?: boolean;
-    updatedAt?: FieldValue;
-    /** NEW: For updating metadata */
-    metadata?: AppointmentMetadata;
-}
-/**
- * Parameters for searching appointments
- */
-interface SearchAppointmentsParams {
-    patientId?: string;
-    practitionerId?: string;
-    clinicBranchId?: string;
-    startDate?: Date;
-    endDate?: Date;
-    status?: AppointmentStatus | AppointmentStatus[];
-    limit?: number;
-    startAfter?: any;
-}
-/** Firestore collection name */
-declare const APPOINTMENTS_COLLECTION = "appointments";
 
 /**
  * Enum for synced calendar provider
@@ -1945,271 +2001,136 @@ interface PaymentConfirmationNotification extends BaseNotification {
  */
 type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | GeneralMessageNotification | PaymentConfirmationNotification;
 
-declare class NotificationsAdmin {
-    private expo;
-    private db;
-    constructor(firestore?: admin.firestore.Firestore);
-    /**
-     * Dohvata notifikaciju po ID-u
-     */
-    getNotification(id: string): Promise<Notification | null>;
-    /**
-     * Kreira novu notifikaciju
-     */
-    createNotification(notification: Omit<Notification, "id">): Promise<string>;
-    /**
-     * Priprema Expo poruku za slanje
-     */
-    private prepareExpoMessage;
-    /**
-     * Ažurira status notifikacije
-     */
-    updateNotificationStatus(notificationId: string, status: NotificationStatus, error?: string): Promise<void>;
+/**
+ * Minimal interface for the new mailgun.js client's messages API
+ * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
+ * or provides clearer typing if it is.
+ */
+interface NewMailgunMessagesAPI$2 {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient$2 {
+    messages: NewMailgunMessagesAPI$2;
+}
+/**
+ * Base mailing service class that provides common functionality for all mailing services
+ * This version is updated to expect a mailgun.js v10+ client.
+ */
+declare class BaseMailingService {
+    protected db: FirebaseFirestore.Firestore;
+    protected mailgunClient: NewMailgunClient$2;
     /**
-     * Šalje notifikaciju kroz Expo servis sa boljim error handlingom
+     * Constructor for BaseMailingService
+     * @param firestore Firestore instance provided by the caller
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    sendPushNotification(notification: Notification): Promise<boolean>;
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
     /**
-     * Procesira notifikacije koje čekaju na slanje sa batch limitom
+     * Sends an email using the new Mailgun client API.
+     * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
+     * @param data Email data to send, compatible with mailgun.js messages.create API
+     * @returns Promise with the sending result
      */
-    processPendingNotifications(batchSize?: number): Promise<void>;
+    protected sendEmail(domain: string, // The new API requires the domain as the first argument to messages.create
+    data: any): Promise<any>;
     /**
-     * Briše stare notifikacije sa batch procesiranjem
+     * 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
      */
-    cleanupOldNotifications(daysOld?: number, batchSize?: number): Promise<void>;
+    protected logEmailAttempt(emailData: {
+        to: string;
+        subject: string;
+        templateName?: string;
+    }, success: boolean, error?: any): Promise<void>;
     /**
-     * Creates and potentially sends a push notification for a confirmed appointment.
-     * @param appointment The confirmed appointment object.
-     * @param recipientUserId The ID of the user receiving the notification.
-     * @param recipientExpoTokens Array of Expo push tokens for the recipient.
-     * @param recipientRole The role of the recipient (e.g., PATIENT, PRACTITIONER).
+     * 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
      */
-    sendAppointmentConfirmedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
-    sendAppointmentCancelledPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
-    sendAppointmentRescheduledProposalPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
-    sendPaymentUpdatePush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
-    sendReviewRequestPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
-    sendReviewAddedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+    protected renderTemplate(template: string, variables: Record<string, string>): string;
 }
 
+interface NewMailgunMessagesAPI$1 {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient$1 {
+    messages: NewMailgunMessagesAPI$1;
+}
 /**
- * @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.
+ * Interface for the data required to send a practitioner invitation email
  */
-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>;
+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;
+        mailgunDomain?: string;
+    };
+}
+/**
+ * Service for sending practitioner invitation emails, updated for mailgun.js v10+
+ */
+declare class PractitionerInviteMailingService extends BaseMailingService {
+    private readonly DEFAULT_REGISTRATION_URL;
+    private readonly DEFAULT_SUBJECT;
+    private readonly DEFAULT_MAILGUN_DOMAIN;
     /**
-     * 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.
+     * Constructor for PractitionerInviteMailingService
+     * @param firestore Firestore instance provided by the caller
+     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    updateClinicInfoInPractitioners(practitionerIds: string[], clinicInfo: ClinicInfo): Promise<void>;
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
     /**
-     * Updates the aggregated clinicInfo field within relevant Procedure documents.
-     * @param procedureIds IDs of procedures performed at the clinic.
-     * @param clinicInfo The updated ClinicInfo object.
+     * Sends a practitioner invitation email
+     * @param data The practitioner invitation data
+     * @returns Promise resolved when email is sent
      */
-    updateClinicInfoInProcedures(procedureIds: string[], clinicInfo: ClinicInfo): Promise<void>;
+    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any>;
     /**
-     * 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.
+     * 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
+     * @param mailgunDomain The mailgun domain to use for sending
+     * @returns Promise resolved when the email is sent
      */
-    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>;
-}
-
-/**
- * Minimal interface for the new mailgun.js client's messages API
- * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
- * or provides clearer typing if it is.
- */
-interface NewMailgunMessagesAPI$2 {
-    create(domain: string, data: any): Promise<any>;
-}
-interface NewMailgunClient$2 {
-    messages: NewMailgunMessagesAPI$2;
-}
-/**
- * Base mailing service class that provides common functionality for all mailing services
- * This version is updated to expect a mailgun.js v10+ client.
- */
-declare class BaseMailingService {
-    protected db: FirebaseFirestore.Firestore;
-    protected mailgunClient: NewMailgunClient$2;
-    /**
-     * Constructor for BaseMailingService
-     * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
-     */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
-    /**
-     * Sends an email using the new Mailgun client API.
-     * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
-     * @param data Email data to send, compatible with mailgun.js messages.create API
-     * @returns Promise with the sending result
-     */
-    protected sendEmail(domain: string, // The new API requires the domain as the first argument to messages.create
-    data: any): Promise<any>;
-    /**
-     * 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;
+    handleTokenCreationEvent(tokenData: PractitionerToken, mailgunConfig: {
+        fromAddress: string;
+        domain: string;
+        registrationUrl?: string;
+    }): Promise<void>;
 }
 
-interface NewMailgunMessagesAPI$1 {
+interface NewMailgunMessagesAPI {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$1 {
-    messages: NewMailgunMessagesAPI$1;
+interface NewMailgunClient {
+    messages: NewMailgunMessagesAPI;
 }
 /**
  * Interface for sending practitioner invitation email data
@@ -2295,7 +2216,7 @@ declare class ExistingPractitionerInviteMailingService extends BaseMailingServic
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
     /**
      * Sends an invitation email to an existing practitioner
      * @param data The invitation email data
@@ -2354,287 +2275,55 @@ declare class ExistingPractitionerInviteMailingService extends BaseMailingServic
 }
 
 /**
- * @class PractitionerInviteAggregationService
- * @description Handles aggregation tasks and side effects related to practitioner invite lifecycle events.
+ * @class AppointmentAggregationService
+ * @description Handles aggregation tasks and side effects related to appointment lifecycle events.
  * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
- * triggered by changes in the practitioner-invites collection.
+ * triggered by changes in the appointments collection.
  */
-declare class PractitionerInviteAggregationService {
+declare class AppointmentAggregationService {
     private db;
-    private mailingService?;
+    private appointmentMailingService;
+    private notificationsAdmin;
+    private calendarAdminService;
+    private patientRequirementsAdminService;
     /**
-     * Constructor for PractitionerInviteAggregationService.
+     * Constructor for AppointmentAggregationService.
+     * @param mailgunClient - An initialized Mailgun client instance.
      * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
-     * @param mailingService Optional mailing service for sending emails
      */
-    constructor(firestore?: admin.firestore.Firestore, mailingService?: ExistingPractitionerInviteMailingService);
+    constructor(mailgunClient: any, // Type as 'any' for now, to be provided by the calling Cloud Function
+    firestore?: admin.firestore.Firestore);
     /**
-     * Handles side effects when a practitioner invite is first created.
-     * This function would typically be called by a Firestore onCreate trigger.
-     * @param {PractitionerInvite} invite - The newly created PractitionerInvite object.
-     * @param {object} emailConfig - Optional email configuration for sending invite emails
+     * Handles side effects when an appointment is first created.
+     * This function would typically be called by an Firestore onCreate trigger.
+     * @param {Appointment} appointment - The newly created Appointment object.
      * @returns {Promise<void>}
      */
-    handleInviteCreate(invite: PractitionerInvite, emailConfig?: {
-        fromAddress: string;
-        domain: string;
-        acceptUrl: string;
-        rejectUrl: string;
-    }): Promise<void>;
+    handleAppointmentCreate(appointment: Appointment): Promise<void>;
     /**
-     * Handles side effects when a practitioner invite is updated.
-     * This function would typically be called by a Firestore onUpdate trigger.
-     * @param {PractitionerInvite} before - The PractitionerInvite object before the update.
-     * @param {PractitionerInvite} after - The PractitionerInvite object after the update.
-     * @param {object} emailConfig - Optional email configuration for sending notification emails
+     * Handles side effects when an appointment is updated.
+     * This function would typically be called by an Firestore onUpdate trigger.
+     * @param {Appointment} before - The Appointment object before the update.
+     * @param {Appointment} after - The Appointment object after the update.
      * @returns {Promise<void>}
      */
-    handleInviteUpdate(before: PractitionerInvite, after: PractitionerInvite, emailConfig?: {
-        fromAddress: string;
-        domain: string;
-        clinicDashboardUrl: string;
-        practitionerProfileUrl?: string;
-        findPractitionersUrl?: string;
-    }): Promise<void>;
+    handleAppointmentUpdate(before: Appointment, after: Appointment): Promise<void>;
     /**
-     * Handles side effects when a practitioner invite is deleted.
-     * @param deletedInvite - The PractitionerInvite object that was deleted.
+     * Handles side effects when an appointment is deleted.
+     * @param deletedAppointment - The Appointment object that was deleted.
      * @returns {Promise<void>}
      */
-    handleInviteDelete(deletedInvite: PractitionerInvite): Promise<void>;
+    handleAppointmentDelete(deletedAppointment: Appointment): Promise<void>;
     /**
-     * Handles the business logic when a practitioner accepts an invite.
-     * This includes adding the practitioner to the clinic and the clinic to the practitioner.
-     * @param {PractitionerInvite} invite - The accepted invite
-     * @param {object} emailConfig - Optional email configuration for sending notification emails
-     * @returns {Promise<void>}
+     * Creates PRE_APPOINTMENT PatientRequirementInstance documents for a given appointment.
+     * Uses the `appointment.preProcedureRequirements` array, which should contain relevant Requirement templates.
+     * For each active PRE requirement template, it constructs a new PatientRequirementInstance document
+     * with derived instructions and batch writes them to Firestore under the patient's `patient_requirements` subcollection.
+     *
+     * @param {Appointment} appointment - The appointment for which to create pre-requirement instances.
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
      */
-    private handleInviteAccepted;
-    /**
-     * Handles the business logic when a practitioner rejects an invite.
-     * @param {PractitionerInvite} invite - The rejected invite
-     * @param {object} emailConfig - Optional email configuration for sending notification emails
-     * @returns {Promise<void>}
-     */
-    private handleInviteRejected;
-    /**
-     * Handles the business logic when an invite is cancelled by admin.
-     * @param {PractitionerInvite} invite - The cancelled invite
-     * @returns {Promise<void>}
-     */
-    private handleInviteCancelled;
-    /**
-     * Adds practitioner information to a clinic when an invite is accepted.
-     * @param clinicId - ID of the clinic to update
-     * @param doctorInfo - Doctor information to add to the clinic
-     * @returns {Promise<void>}
-     */
-    private addPractitionerToClinic;
-    /**
-     * Updates practitioner information in a clinic.
-     * @param clinicId - ID of the clinic to update
-     * @param doctorInfo - Updated doctor information
-     * @returns {Promise<void>}
-     */
-    private updatePractitionerInfoInClinic;
-    /**
-     * Adds a clinic to a practitioner's profile with working hours from the invite.
-     * @param {string} practitionerId - The practitioner ID
-     * @param {ClinicInfo} clinicInfo - The clinic information
-     * @param {PractitionerInvite} invite - The accepted invite containing working hours
-     * @returns {Promise<void>}
-     */
-    private addClinicToPractitioner;
-    /**
-     * Updates the working hours for an existing practitioner-clinic relationship.
-     * @param {string} practitionerId - The practitioner ID
-     * @param {PractitionerInvite} invite - The accepted invite containing new working hours
-     * @returns {Promise<void>}
-     */
-    private updatePractitionerWorkingHours;
-    /**
-     * Fetches a clinic admin by ID
-     * @param adminId The clinic admin ID
-     * @returns The clinic admin or null if not found
-     */
-    private fetchClinicAdminById;
-    /**
-     * Fetches a practitioner by ID.
-     * @param practitionerId The practitioner ID.
-     * @returns {Promise<Practitioner | null>} The practitioner or null if not found.
-     */
-    private fetchPractitionerById;
-    /**
-     * Fetches a clinic by ID.
-     * @param clinicId The clinic ID.
-     * @returns {Promise<Clinic | null>} The clinic or null if not found.
-     */
-    private fetchClinicById;
-    /**
-     * Sends acceptance notification email to clinic admin
-     * @param invite The accepted invite
-     * @param practitioner The practitioner who accepted
-     * @param clinic The clinic that sent the invite
-     * @param emailConfig Email configuration
-     */
-    private sendAcceptanceNotificationEmail;
-    /**
-     * Sends rejection notification email to clinic admin
-     * @param invite The rejected invite
-     * @param practitioner The practitioner who rejected
-     * @param clinic The clinic that sent the invite
-     * @param emailConfig Email configuration
-     */
-    private sendRejectionNotificationEmail;
-}
-
-/**
- * @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
-     * @param clinicId - Optional clinic ID for free consultation removal
-     * @returns {Promise<void>}
-     */
-    removeProcedureFromPractitioner(practitionerId: string, procedureId: string, clinicId?: 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>;
-    /**
-     * Handles procedure status changes (activation/deactivation) specifically for free consultations
-     * @param practitionerId - ID of the practitioner who performs the procedure
-     * @param procedureId - ID of the procedure
-     * @param clinicId - ID of the clinic where the procedure is performed
-     * @param isActive - New active status of the procedure
-     * @param technologyName - Technology name of the procedure (to check if it's a free consultation)
-     * @returns {Promise<void>}
-     */
-    handleFreeConsultationStatusChange(practitionerId: string, procedureId: string, clinicId: string, isActive: boolean, technologyName: 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>;
-}
-
-/**
- * @class AppointmentAggregationService
- * @description Handles aggregation tasks and side effects related to appointment lifecycle events.
- * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
- * triggered by changes in the appointments collection.
- */
-declare class AppointmentAggregationService {
-    private db;
-    private appointmentMailingService;
-    private notificationsAdmin;
-    private calendarAdminService;
-    private patientRequirementsAdminService;
-    /**
-     * Constructor for AppointmentAggregationService.
-     * @param mailgunClient - An initialized Mailgun client instance.
-     * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
-     */
-    constructor(mailgunClient: any, // Type as 'any' for now, to be provided by the calling Cloud Function
-    firestore?: admin.firestore.Firestore);
-    /**
-     * Handles side effects when an appointment is first created.
-     * This function would typically be called by an Firestore onCreate trigger.
-     * @param {Appointment} appointment - The newly created Appointment object.
-     * @returns {Promise<void>}
-     */
-    handleAppointmentCreate(appointment: Appointment): Promise<void>;
-    /**
-     * Handles side effects when an appointment is updated.
-     * This function would typically be called by an Firestore onUpdate trigger.
-     * @param {Appointment} before - The Appointment object before the update.
-     * @param {Appointment} after - The Appointment object after the update.
-     * @returns {Promise<void>}
-     */
-    handleAppointmentUpdate(before: Appointment, after: Appointment): Promise<void>;
-    /**
-     * Handles side effects when an appointment is deleted.
-     * @param deletedAppointment - The Appointment object that was deleted.
-     * @returns {Promise<void>}
-     */
-    handleAppointmentDelete(deletedAppointment: Appointment): Promise<void>;
-    /**
-     * Creates PRE_APPOINTMENT PatientRequirementInstance documents for a given appointment.
-     * Uses the `appointment.preProcedureRequirements` array, which should contain relevant Requirement templates.
-     * For each active PRE requirement template, it constructs a new PatientRequirementInstance document
-     * with derived instructions and batch writes them to Firestore under the patient's `patient_requirements` subcollection.
-     *
-     * @param {Appointment} appointment - The appointment for which to create pre-requirement instances.
-     * @returns {Promise<void>} A promise that resolves when the operation is complete.
-     */
-    private createPreAppointmentRequirementInstances;
+    private createPreAppointmentRequirementInstances;
     /**
      * Creates POST_APPOINTMENT PatientRequirementInstance documents for a given appointment.
      * Uses the `appointment.postProcedureRequirements` array.
@@ -2715,40 +2404,433 @@ declare class AppointmentAggregationService {
 }
 
 /**
- * @class FilledFormsAggregationService
- * @description Handles aggregation tasks related to filled forms data updates.
- * Updates appointment documents with LinkedFormInfo when forms are created, updated, or deleted.
+ * @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 FilledFormsAggregationService {
+declare class ClinicAggregationService {
     private db;
     /**
-     * Constructor for FilledFormsAggregationService.
+     * Constructor for ClinicAggregationService.
      * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
      */
     constructor(firestore?: admin.firestore.Firestore);
     /**
-     * Handles side effects when a filled form is created or updated.
-     * This function would typically be called by a Firestore onCreate or onUpdate trigger.
-     * @param filledDocument The filled document that was created or updated.
+     * 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
      */
-    handleFilledFormCreateOrUpdate(filledDocument: FilledDocument): Promise<void>;
+    addClinicToClinicGroup(clinicGroupId: string, clinicInfo: ClinicInfo): Promise<void>;
     /**
-     * Handles side effects when a filled form is deleted.
-     * This function would typically be called by a Firestore onDelete trigger.
-     * @param filledDocument The filled document that was deleted.
+     * 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.
      */
-    handleFilledFormDelete(filledDocument: FilledDocument): Promise<void>;
+    updateClinicInfoInPractitioners(practitionerIds: string[], clinicInfo: ClinicInfo): Promise<void>;
     /**
-     * Updates the appointment's pendingUserFormsIds for a new required user form.
-     * This should be called when a required user form is first created.
-     * @param filledDocument The newly created filled document.
-     * @returns {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 FilledFormsAggregationService
+ * @description Handles aggregation tasks related to filled forms data updates.
+ * Updates appointment documents with LinkedFormInfo when forms are created, updated, or deleted.
+ */
+declare class FilledFormsAggregationService {
+    private db;
+    /**
+     * Constructor for FilledFormsAggregationService.
+     * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
+     */
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Handles side effects when a filled form is created or updated.
+     * This function would typically be called by a Firestore onCreate or onUpdate trigger.
+     * @param filledDocument The filled document that was created or updated.
+     * @returns {Promise<void>}
+     */
+    handleFilledFormCreateOrUpdate(filledDocument: FilledDocument): Promise<void>;
+    /**
+     * Handles side effects when a filled form is deleted.
+     * This function would typically be called by a Firestore onDelete trigger.
+     * @param filledDocument The filled document that was deleted.
+     * @returns {Promise<void>}
+     */
+    handleFilledFormDelete(filledDocument: FilledDocument): Promise<void>;
+    /**
+     * Updates the appointment's pendingUserFormsIds for a new required user form.
+     * This should be called when a required user form is first created.
+     * @param filledDocument The newly created filled document.
+     * @returns {Promise<void>}
      */
     handleRequiredUserFormCreate(filledDocument: FilledDocument): 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>;
+}
+
+/**
+ * @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 PractitionerInviteAggregationService
+ * @description Handles aggregation tasks and side effects related to practitioner invite lifecycle events.
+ * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
+ * triggered by changes in the practitioner-invites collection.
+ */
+declare class PractitionerInviteAggregationService {
+    private db;
+    private mailingService?;
+    /**
+     * Constructor for PractitionerInviteAggregationService.
+     * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
+     * @param mailingService Optional mailing service for sending emails
+     */
+    constructor(firestore?: admin.firestore.Firestore, mailingService?: ExistingPractitionerInviteMailingService);
+    /**
+     * Handles side effects when a practitioner invite is first created.
+     * This function would typically be called by a Firestore onCreate trigger.
+     * @param {PractitionerInvite} invite - The newly created PractitionerInvite object.
+     * @param {object} emailConfig - Optional email configuration for sending invite emails
+     * @returns {Promise<void>}
+     */
+    handleInviteCreate(invite: PractitionerInvite, emailConfig?: {
+        fromAddress: string;
+        domain: string;
+        acceptUrl: string;
+        rejectUrl: string;
+    }): Promise<void>;
+    /**
+     * Handles side effects when a practitioner invite is updated.
+     * This function would typically be called by a Firestore onUpdate trigger.
+     * @param {PractitionerInvite} before - The PractitionerInvite object before the update.
+     * @param {PractitionerInvite} after - The PractitionerInvite object after the update.
+     * @param {object} emailConfig - Optional email configuration for sending notification emails
+     * @returns {Promise<void>}
+     */
+    handleInviteUpdate(before: PractitionerInvite, after: PractitionerInvite, emailConfig?: {
+        fromAddress: string;
+        domain: string;
+        clinicDashboardUrl: string;
+        practitionerProfileUrl?: string;
+        findPractitionersUrl?: string;
+    }): Promise<void>;
+    /**
+     * Handles side effects when a practitioner invite is deleted.
+     * @param deletedInvite - The PractitionerInvite object that was deleted.
+     * @returns {Promise<void>}
+     */
+    handleInviteDelete(deletedInvite: PractitionerInvite): Promise<void>;
+    /**
+     * Handles the business logic when a practitioner accepts an invite.
+     * This includes adding the practitioner to the clinic and the clinic to the practitioner.
+     * @param {PractitionerInvite} invite - The accepted invite
+     * @param {object} emailConfig - Optional email configuration for sending notification emails
+     * @returns {Promise<void>}
+     */
+    private handleInviteAccepted;
+    /**
+     * Handles the business logic when a practitioner rejects an invite.
+     * @param {PractitionerInvite} invite - The rejected invite
+     * @param {object} emailConfig - Optional email configuration for sending notification emails
+     * @returns {Promise<void>}
+     */
+    private handleInviteRejected;
+    /**
+     * Handles the business logic when an invite is cancelled by admin.
+     * @param {PractitionerInvite} invite - The cancelled invite
+     * @returns {Promise<void>}
+     */
+    private handleInviteCancelled;
+    /**
+     * Adds practitioner information to a clinic when an invite is accepted.
+     * @param clinicId - ID of the clinic to update
+     * @param doctorInfo - Doctor information to add to the clinic
+     * @returns {Promise<void>}
+     */
+    private addPractitionerToClinic;
+    /**
+     * Updates practitioner information in a clinic.
+     * @param clinicId - ID of the clinic to update
+     * @param doctorInfo - Updated doctor information
+     * @returns {Promise<void>}
+     */
+    private updatePractitionerInfoInClinic;
+    /**
+     * Adds a clinic to a practitioner's profile with working hours from the invite.
+     * @param {string} practitionerId - The practitioner ID
+     * @param {ClinicInfo} clinicInfo - The clinic information
+     * @param {PractitionerInvite} invite - The accepted invite containing working hours
+     * @returns {Promise<void>}
+     */
+    private addClinicToPractitioner;
+    /**
+     * Updates the working hours for an existing practitioner-clinic relationship.
+     * @param {string} practitionerId - The practitioner ID
+     * @param {PractitionerInvite} invite - The accepted invite containing new working hours
+     * @returns {Promise<void>}
+     */
+    private updatePractitionerWorkingHours;
+    /**
+     * Fetches a clinic admin by ID
+     * @param adminId The clinic admin ID
+     * @returns The clinic admin or null if not found
+     */
+    private fetchClinicAdminById;
+    /**
+     * Fetches a practitioner by ID.
+     * @param practitionerId The practitioner ID.
+     * @returns {Promise<Practitioner | null>} The practitioner or null if not found.
+     */
+    private fetchPractitionerById;
+    /**
+     * Fetches a clinic by ID.
+     * @param clinicId The clinic ID.
+     * @returns {Promise<Clinic | null>} The clinic or null if not found.
+     */
+    private fetchClinicById;
+    /**
+     * Sends acceptance notification email to clinic admin
+     * @param invite The accepted invite
+     * @param practitioner The practitioner who accepted
+     * @param clinic The clinic that sent the invite
+     * @param emailConfig Email configuration
+     */
+    private sendAcceptanceNotificationEmail;
+    /**
+     * Sends rejection notification email to clinic admin
+     * @param invite The rejected invite
+     * @param practitioner The practitioner who rejected
+     * @param clinic The clinic that sent the invite
+     * @param emailConfig Email configuration
+     */
+    private sendRejectionNotificationEmail;
+}
+
+/**
+ * @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
+     * @param clinicId - Optional clinic ID for free consultation removal
+     * @returns {Promise<void>}
+     */
+    removeProcedureFromPractitioner(practitionerId: string, procedureId: string, clinicId?: 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>;
+    /**
+     * Handles procedure status changes (activation/deactivation) specifically for free consultations
+     * @param practitionerId - ID of the practitioner who performs the procedure
+     * @param procedureId - ID of the procedure
+     * @param clinicId - ID of the clinic where the procedure is performed
+     * @param isActive - New active status of the procedure
+     * @param technologyName - Technology name of the procedure (to check if it's a free consultation)
+     * @returns {Promise<void>}
+     */
+    handleFreeConsultationStatusChange(practitionerId: string, procedureId: string, clinicId: string, isActive: boolean, technologyName: string): Promise<void>;
+}
+
 /**
  * @class ReviewsAggregationService
  * @description Handles aggregation tasks related to review data updates.
@@ -2791,244 +2873,31 @@ declare class ReviewsAggregationService {
      */
     updatePractitionerReviewInfo(practitionerId: string, removedReview?: PractitionerReview, isRemoval?: boolean): Promise<PractitionerReviewInfo>;
     /**
-     * Updates the review info for a procedure
-     * @param procedureId The ID of the procedure to update
-     * @param removedReview Optional review being removed
-     * @param isRemoval Whether this update is for a review removal
-     * @returns The updated procedure review info
-     */
-    updateProcedureReviewInfo(procedureId: string, removedReview?: ProcedureReview, isRemoval?: boolean): Promise<ProcedureReviewInfo>;
-    /**
-     * Updates doctorInfo rating in all procedures for a practitioner
-     * @param practitionerId The ID of the practitioner
-     * @param rating The new rating to set
-     */
-    private updateDoctorInfoInProcedures;
-    /**
-     * Verifies a review as checked by admin/staff
-     * @param reviewId The ID of the review to verify
-     */
-    verifyReview(reviewId: string): Promise<void>;
-    /**
-     * Calculate the average of all reviews for an entity
-     * @param entityId The entity ID
-     * @param entityType The type of entity ('clinic', 'practitioner', or 'procedure')
-     * @returns Promise that resolves to the calculated review info
-     */
-    calculateEntityReviewInfo(entityId: string, entityType: "clinic" | "practitioner" | "procedure"): Promise<ClinicReviewInfo | PractitionerReviewInfo | ProcedureReviewInfo>;
-}
-
-interface NewMailgunMessagesAPI {
-    create(domain: string, data: any): Promise<any>;
-}
-interface NewMailgunClient {
-    messages: NewMailgunMessagesAPI;
-}
-/**
- * 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;
-        mailgunDomain?: string;
-    };
-}
-/**
- * Service for sending practitioner invitation emails, updated for mailgun.js v10+
- */
-declare class PractitionerInviteMailingService extends BaseMailingService {
-    private readonly DEFAULT_REGISTRATION_URL;
-    private readonly DEFAULT_SUBJECT;
-    private readonly DEFAULT_MAILGUN_DOMAIN;
-    /**
-     * Constructor for PractitionerInviteMailingService
-     * @param firestore Firestore instance provided by the caller
-     * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
-     */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
-    /**
-     * Sends a practitioner invitation email
-     * @param data The practitioner invitation data
-     * @returns Promise resolved when email is sent
-     */
-    sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any>;
-    /**
-     * 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
-     * @param mailgunDomain The mailgun domain to use for sending
-     * @returns Promise resolved when the email is sent
-     */
-    handleTokenCreationEvent(tokenData: PractitionerToken, mailgunConfig: {
-        fromAddress: string;
-        domain: string;
-        registrationUrl?: string;
-    }): Promise<void>;
-}
-
-/**
- * Interface for the data required by orchestrateAppointmentCreation
- */
-interface OrchestrateAppointmentCreationData {
-    patientId: string;
-    procedureId: string;
-    appointmentStartTime: admin.firestore.Timestamp;
-    appointmentEndTime: admin.firestore.Timestamp;
-    patientNotes?: string | null;
-}
-/**
- * Admin service for handling booking-related operations.
- * This is the cloud-based implementation that will be used in Cloud Functions.
- */
-declare class BookingAdmin {
-    private db;
-    private documentManagerAdmin;
-    /**
-     * Creates a new BookingAdmin instance
-     * @param firestore - Firestore instance provided by the caller
-     */
-    constructor(firestore?: admin.firestore.Firestore);
-    /**
-     * Gets available booking time slots for a specific clinic, practitioner, and procedure
-     *
-     * @param clinicId - ID of the clinic
-     * @param practitionerId - ID of the practitioner
-     * @param procedureId - ID of the procedure
-     * @param timeframe - Time range to check for availability
-     * @returns Promise resolving to an array of available booking slots
-     */
-    getAvailableBookingSlots(clinicId: string, practitionerId: string, procedureId: string, timeframe: {
-        start: Date | admin.firestore.Timestamp;
-        end: Date | admin.firestore.Timestamp;
-    }): Promise<{
-        availableSlots: {
-            start: admin.firestore.Timestamp;
-        }[];
-    }>;
-    /**
-     * Converts an admin Firestore Timestamp to a client Firestore Timestamp
-     */
-    private adminTimestampToClientTimestamp;
-    /**
-     * Converts timestamps in calendar events from admin Firestore Timestamps to client Firestore Timestamps
-     */
-    private convertEventsTimestamps;
-    /**
-     * Fetches clinic calendar events for a specific time range
-     *
-     * @param clinicId - ID of the clinic
-     * @param start - Start time of the range
-     * @param end - End time of the range
-     * @returns Promise resolving to an array of calendar events
-     */
-    private getClinicCalendarEvents;
-    /**
-     * Fetches practitioner calendar events for a specific time range
-     *
-     * @param practitionerId - ID of the practitioner
-     * @param start - Start time of the range
-     * @param end - End time of the range
-     * @returns Promise resolving to an array of calendar events
-     */
-    private getPractitionerCalendarEvents;
-    /**
-     * Summarizes event types for logging purposes
-     * @param events Array of calendar events
-     * @returns Object with counts of each event type
-     */
-    private summarizeEventTypes;
-    private _generateCalendarProcedureInfo;
-    /**
-     * Orchestrates the creation of a new appointment, including data aggregation.
-     * This method is intended to be called from a trusted backend environment (e.g., an Express route handler in a Cloud Function).
-     *
-     * @param data - Data required to create the appointment.
-     * @param authenticatedUserId - The ID of the user making the request (for auditing, and usually is the patientId).
-     * @returns Promise resolving to an object indicating success, and appointmentId or an error message.
-     */
-    orchestrateAppointmentCreation(data: OrchestrateAppointmentCreationData, authenticatedUserId: string): Promise<{
-        success: boolean;
-        appointmentId?: string;
-        appointmentData?: Appointment;
-        calendarEventId?: string;
-        error?: string;
-    }>;
-    private _generateProcedureSummaryInfo;
-    private _generateProcedureExtendedInfo;
-}
-
-/**
- * @class PatientRequirementsAdminService
- * @description Handles administrative tasks for patient requirement instances, primarily managing associated notifications.
- * This service is intended to be used by Cloud Functions triggered by changes to PatientRequirementInstance documents.
- */
-declare class PatientRequirementsAdminService {
-    private db;
-    private notificationsAdmin;
-    constructor(firestore?: admin.firestore.Firestore);
-    /**
-     * Processes a newly created or updated PatientRequirementInstance to schedule notifications for its instructions.
-     * It will also cancel pre-existing notifications if due times have changed significantly.
-     *
-     * @param patientId - The ID of the patient.
-     * @param instance - The PatientRequirementInstance data (either new or updated).
-     * @param previousInstanceData - Optional. The previous state of the instance data if it's an update.
-     *                                 Used to determine if notifications need to be cancelled/rescheduled.
-     * @returns {Promise<void>} A promise that resolves when processing is complete.
+     * Updates the review info for a procedure
+     * @param procedureId The ID of the procedure to update
+     * @param removedReview Optional review being removed
+     * @param isRemoval Whether this update is for a review removal
+     * @returns The updated procedure review info
      */
-    processRequirementInstanceAndScheduleNotifications(patientId: string, instance: PatientRequirementInstance, previousInstanceData?: PatientRequirementInstance): Promise<void>;
+    updateProcedureReviewInfo(procedureId: string, removedReview?: ProcedureReview, isRemoval?: boolean): Promise<ProcedureReviewInfo>;
     /**
-     * Cancels all PENDING notifications associated with a specific PatientRequirementInstance.
-     * Typically called when the instance itself is deleted or its overall status becomes CANCELLED.
-     *
-     * @param instance - The PatientRequirementInstance.
-     * @returns {Promise<void>}
+     * Updates doctorInfo rating in all procedures for a practitioner
+     * @param practitionerId The ID of the practitioner
+     * @param rating The new rating to set
      */
-    cancelAllNotificationsForInstance(instance: PatientRequirementInstance): Promise<void>;
+    private updateDoctorInfoInProcedures;
     /**
-     * (Optional - For a cron job)
-     * Scans for instructions that are past their due time but not yet actioned, and updates their status to MISSED.
-     * This would typically be called by a scheduled Cloud Function.
-     *
-     * @param patientId - The ID of the patient.
-     * @param instanceId - The ID of the PatientRequirementInstance.
-     * @returns {Promise<void>}
+     * Verifies a review as checked by admin/staff
+     * @param reviewId The ID of the review to verify
      */
-    updateMissedInstructions(patientId: string, instanceId: string): Promise<void>;
+    verifyReview(reviewId: string): Promise<void>;
     /**
-     * Calculates and updates the overallStatus of a PatientRequirementInstance
-     * based on the statuses of its individual instructions.
-     *
-     * @param patientId - The ID of the patient.
-     * @param instanceId - The ID of the PatientRequirementInstance to update.
-     * @returns {Promise<void>} A promise that resolves when processing is complete.
+     * Calculate the average of all reviews for an entity
+     * @param entityId The entity ID
+     * @param entityType The type of entity ('clinic', 'practitioner', or 'procedure')
+     * @returns Promise that resolves to the calculated review info
      */
-    updateOverallInstanceStatus(patientId: string, instanceId: string): Promise<void>;
+    calculateEntityReviewInfo(entityId: string, entityType: "clinic" | "practitioner" | "procedure"): Promise<ClinicReviewInfo | PractitionerReviewInfo | ProcedureReviewInfo>;
 }
 
 /**
@@ -3185,6 +3054,97 @@ declare class BookingAvailabilityCalculator {
     private static mergeOverlappingIntervals;
 }
 
+/**
+ * Interface for the data required by orchestrateAppointmentCreation
+ */
+interface OrchestrateAppointmentCreationData {
+    patientId: string;
+    procedureId: string;
+    appointmentStartTime: admin.firestore.Timestamp;
+    appointmentEndTime: admin.firestore.Timestamp;
+    patientNotes?: string | null;
+}
+/**
+ * Admin service for handling booking-related operations.
+ * This is the cloud-based implementation that will be used in Cloud Functions.
+ */
+declare class BookingAdmin {
+    private db;
+    private documentManagerAdmin;
+    /**
+     * Creates a new BookingAdmin instance
+     * @param firestore - Firestore instance provided by the caller
+     */
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Gets available booking time slots for a specific clinic, practitioner, and procedure
+     *
+     * @param clinicId - ID of the clinic
+     * @param practitionerId - ID of the practitioner
+     * @param procedureId - ID of the procedure
+     * @param timeframe - Time range to check for availability
+     * @returns Promise resolving to an array of available booking slots
+     */
+    getAvailableBookingSlots(clinicId: string, practitionerId: string, procedureId: string, timeframe: {
+        start: Date | admin.firestore.Timestamp;
+        end: Date | admin.firestore.Timestamp;
+    }): Promise<{
+        availableSlots: {
+            start: admin.firestore.Timestamp;
+        }[];
+    }>;
+    /**
+     * Converts an admin Firestore Timestamp to a client Firestore Timestamp
+     */
+    private adminTimestampToClientTimestamp;
+    /**
+     * Converts timestamps in calendar events from admin Firestore Timestamps to client Firestore Timestamps
+     */
+    private convertEventsTimestamps;
+    /**
+     * Fetches clinic calendar events for a specific time range
+     *
+     * @param clinicId - ID of the clinic
+     * @param start - Start time of the range
+     * @param end - End time of the range
+     * @returns Promise resolving to an array of calendar events
+     */
+    private getClinicCalendarEvents;
+    /**
+     * Fetches practitioner calendar events for a specific time range
+     *
+     * @param practitionerId - ID of the practitioner
+     * @param start - Start time of the range
+     * @param end - End time of the range
+     * @returns Promise resolving to an array of calendar events
+     */
+    private getPractitionerCalendarEvents;
+    /**
+     * Summarizes event types for logging purposes
+     * @param events Array of calendar events
+     * @returns Object with counts of each event type
+     */
+    private summarizeEventTypes;
+    private _generateCalendarProcedureInfo;
+    /**
+     * Orchestrates the creation of a new appointment, including data aggregation.
+     * This method is intended to be called from a trusted backend environment (e.g., an Express route handler in a Cloud Function).
+     *
+     * @param data - Data required to create the appointment.
+     * @param authenticatedUserId - The ID of the user making the request (for auditing, and usually is the patientId).
+     * @returns Promise resolving to an object indicating success, and appointmentId or an error message.
+     */
+    orchestrateAppointmentCreation(data: OrchestrateAppointmentCreationData, authenticatedUserId: string): Promise<{
+        success: boolean;
+        appointmentId?: string;
+        appointmentData?: Appointment;
+        calendarEventId?: string;
+        error?: string;
+    }>;
+    private _generateProcedureSummaryInfo;
+    private _generateProcedureExtendedInfo;
+}
+
 /**
  * @class CalendarAdminService
  * @description Handles administrative tasks for calendar events linked to appointments,
@@ -3264,6 +3224,14 @@ declare class DocumentManagerAdminService {
     batchInitializeAppointmentFormsFromTechnologyTemplates(dbBatch: admin.firestore.WriteBatch, appointmentId: string, procedureIdForForms: string, technologyTemplates: TechnologyDocumentationTemplate[], patientId: string, practitionerId: string, clinicId: string, nowMillis: number): Promise<InitializeAppointmentFormsResult>;
 }
 
+/**
+ * Ensures that the free consultation infrastructure exists in the database
+ * Creates category, subcategory, and technology if they don't exist
+ * @param db - Firestore database instance (optional, defaults to admin.firestore())
+ * @returns Promise<boolean> - Always returns true after ensuring infrastructure exists
+ */
+declare function freeConsultationInfrastructure(db?: admin.firestore.Firestore): Promise<boolean>;
+
 /**
  * Cloud Functions-compatible logger with fallback for other environments
  *
@@ -3351,12 +3319,152 @@ declare class AppointmentMailingService extends BaseMailingService {
     sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any>;
 }
 
+declare class NotificationsAdmin {
+    private expo;
+    private db;
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Dohvata notifikaciju po ID-u
+     */
+    getNotification(id: string): Promise<Notification | null>;
+    /**
+     * Kreira novu notifikaciju
+     */
+    createNotification(notification: Omit<Notification, "id">): Promise<string>;
+    /**
+     * Priprema Expo poruku za slanje
+     */
+    private prepareExpoMessage;
+    /**
+     * Ažurira status notifikacije
+     */
+    updateNotificationStatus(notificationId: string, status: NotificationStatus, error?: string): Promise<void>;
+    /**
+     * Šalje notifikaciju kroz Expo servis sa boljim error handlingom
+     */
+    sendPushNotification(notification: Notification): Promise<boolean>;
+    /**
+     * Procesira notifikacije koje čekaju na slanje sa batch limitom
+     */
+    processPendingNotifications(batchSize?: number): Promise<void>;
+    /**
+     * Briše stare notifikacije sa batch procesiranjem
+     */
+    cleanupOldNotifications(daysOld?: number, batchSize?: number): Promise<void>;
+    /**
+     * Creates and potentially sends a push notification for a confirmed appointment.
+     * @param appointment The confirmed appointment object.
+     * @param recipientUserId The ID of the user receiving the notification.
+     * @param recipientExpoTokens Array of Expo push tokens for the recipient.
+     * @param recipientRole The role of the recipient (e.g., PATIENT, PRACTITIONER).
+     */
+    sendAppointmentConfirmedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+    sendAppointmentCancelledPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+    sendAppointmentRescheduledProposalPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendPaymentUpdatePush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendReviewRequestPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendReviewAddedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+}
+
 /**
- * Ensures that the free consultation infrastructure exists in the database
- * Creates category, subcategory, and technology if they don't exist
- * @param db - Firestore database instance (optional, defaults to admin.firestore())
- * @returns Promise<boolean> - Always returns true after ensuring infrastructure exists
+ * @class PatientRequirementsAdminService
+ * @description Handles administrative tasks for patient requirement instances, primarily managing associated notifications.
+ * This service is intended to be used by Cloud Functions triggered by changes to PatientRequirementInstance documents.
  */
-declare function freeConsultationInfrastructure(db?: admin.firestore.Firestore): Promise<boolean>;
+declare class PatientRequirementsAdminService {
+    private db;
+    private notificationsAdmin;
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Processes a newly created or updated PatientRequirementInstance to schedule notifications for its instructions.
+     * It will also cancel pre-existing notifications if due times have changed significantly.
+     *
+     * @param patientId - The ID of the patient.
+     * @param instance - The PatientRequirementInstance data (either new or updated).
+     * @param previousInstanceData - Optional. The previous state of the instance data if it's an update.
+     *                                 Used to determine if notifications need to be cancelled/rescheduled.
+     * @returns {Promise<void>} A promise that resolves when processing is complete.
+     */
+    processRequirementInstanceAndScheduleNotifications(patientId: string, instance: PatientRequirementInstance, previousInstanceData?: PatientRequirementInstance): Promise<void>;
+    /**
+     * Cancels all PENDING notifications associated with a specific PatientRequirementInstance.
+     * Typically called when the instance itself is deleted or its overall status becomes CANCELLED.
+     *
+     * @param instance - The PatientRequirementInstance.
+     * @returns {Promise<void>}
+     */
+    cancelAllNotificationsForInstance(instance: PatientRequirementInstance): Promise<void>;
+    /**
+     * (Optional - For a cron job)
+     * Scans for instructions that are past their due time but not yet actioned, and updates their status to MISSED.
+     * This would typically be called by a scheduled Cloud Function.
+     *
+     * @param patientId - The ID of the patient.
+     * @param instanceId - The ID of the PatientRequirementInstance.
+     * @returns {Promise<void>}
+     */
+    updateMissedInstructions(patientId: string, instanceId: string): Promise<void>;
+    /**
+     * Calculates and updates the overallStatus of a PatientRequirementInstance
+     * based on the statuses of its individual instructions.
+     *
+     * @param patientId - The ID of the patient.
+     * @param instanceId - The ID of the PatientRequirementInstance to update.
+     * @returns {Promise<void>} A promise that resolves when processing is complete.
+     */
+    updateOverallInstanceStatus(patientId: string, instanceId: string): Promise<void>;
+}
+
+/**
+ * @class UserProfileAdminService
+ * @description Handles user profile management operations for admin tasks
+ */
+declare class UserProfileAdminService {
+    private db;
+    /**
+     * Constructor for UserProfileAdminService
+     * @param firestore Optional Firestore instance. If not provided, uses the default admin SDK instance.
+     */
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Creates a blank user profile with minimal information
+     * @param authUserData Basic user data from Firebase Auth
+     * @returns The created user document
+     */
+    createBlankUserProfile(authUserData: {
+        uid: string;
+        email: string | null;
+        isAnonymous: boolean;
+    }): Promise<User>;
+    /**
+     * Initializes patient role for a user and creates all required patient documents
+     * Creates patient profile, sensitive info, and medical info in one operation
+     *
+     * @param userId The user ID to initialize with patient role
+     * @param options Optional data for different aspects of patient initialization
+     * @returns Object containing the updated user and all created patient documents
+     */
+    initializePatientRole(userId: string, options?: {
+        profileData?: Partial<CreatePatientProfileData>;
+        sensitiveData?: Partial<CreatePatientSensitiveInfoData>;
+    }): Promise<{
+        user: User;
+        patientProfile: PatientProfile;
+        patientSensitiveInfo: PatientSensitiveInfo;
+        patientMedicalInfo: PatientMedicalInfo;
+    }>;
+    /**
+     * Initializes clinic admin role for a user
+     * @param userId The user ID to initialize with clinic admin role
+     * @returns The updated user document
+     */
+    initializeClinicAdminRole(userId: string): Promise<User>;
+    /**
+     * Initializes practitioner role for a user
+     * @param userId The user ID to initialize with practitioner role
+     * @returns The updated user document
+     */
+    initializePractitionerRole(userId: string): Promise<User>;
+}
 
-export { APPOINTMENTS_COLLECTION, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, type BeforeAfterPerZone, type BillingPerZone, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateAppointmentData, type CreateAppointmentHttpData, type DoctorInfo, DocumentManagerAdminService, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type FinalBilling, type InitializeAppointmentFormsResult, type LinkedFormInfo, Logger, MediaType, NOTIFICATIONS_COLLECTION, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientReviewInfo, type PatientSensitiveInfo, PaymentStatus, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerInvite, PractitionerInviteAggregationService, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureExtendedInfo, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type SearchAppointmentsParams, type TimeInterval, type UpdateAppointmentData, UserRole, freeConsultationInfrastructure };
+export { type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type DoctorInfo, DocumentManagerAdminService, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, type NewMailgunClient$2 as NewMailgunClient, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, type PatientProfile as Patient, PatientAggregationService, PatientInstructionStatus, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientSensitiveInfo, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureSummaryInfo, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type TimeInterval, UserProfileAdminService, UserRole, freeConsultationInfrastructure };