@blackcode_sa/metaestetics-api 1.12.68 → 1.13.0

package/dist/admin/index.d.mts

@@ -977,6 +977,8 @@ interface PractitionerInvite {
     cancelledAt?: Timestamp | null;
 }
 
+declare const CLINICS_COLLECTION = "clinics";
+
 /**
  * Interface for clinic contact information
  */
@@ -2039,6 +2041,732 @@ interface PatientRequirementInstance {
  */
 declare const PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME = "patientRequirements";
 
+/**
+ * Base metrics interface with common properties
+ */
+interface BaseMetrics {
+    total: number;
+    dateRange?: {
+        start: Date;
+        end: Date;
+    };
+}
+/**
+ * Date range filter for analytics queries
+ */
+interface AnalyticsDateRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * Common filters for analytics queries
+ */
+interface AnalyticsFilters {
+    clinicBranchId?: string;
+    practitionerId?: string;
+    procedureId?: string;
+    patientId?: string;
+}
+/**
+ * Grouping period for trend analysis
+ */
+type GroupingPeriod = 'day' | 'week' | 'month';
+/**
+ * Entity type for grouping analytics
+ */
+type EntityType = 'clinic' | 'practitioner' | 'patient' | 'procedure' | 'technology';
+/**
+ * Practitioner Analytics
+ * Comprehensive metrics for a practitioner's performance
+ */
+interface PractitionerAnalytics extends BaseMetrics {
+    practitionerId: string;
+    practitionerName: string;
+    totalAppointments: number;
+    completedAppointments: number;
+    canceledAppointments: number;
+    noShowAppointments: number;
+    pendingAppointments: number;
+    confirmedAppointments: number;
+    cancellationRate: number;
+    noShowRate: number;
+    averageBookedTime: number;
+    averageActualTime: number;
+    timeEfficiency: number;
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    currency: string;
+    topProcedures: Array<{
+        procedureId: string;
+        procedureName: string;
+        count: number;
+        revenue: number;
+    }>;
+    patientRetentionRate: number;
+    uniquePatients: number;
+}
+/**
+ * Procedure Analytics
+ * Comprehensive metrics for procedure performance
+ */
+interface ProcedureAnalytics extends BaseMetrics {
+    procedureId: string;
+    procedureName: string;
+    procedureFamily: string;
+    categoryName: string;
+    subcategoryName: string;
+    technologyName: string;
+    totalAppointments: number;
+    completedAppointments: number;
+    canceledAppointments: number;
+    noShowAppointments: number;
+    cancellationRate: number;
+    noShowRate: number;
+    averageCost: number;
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    currency: string;
+    averageBookedDuration: number;
+    averageActualDuration: number;
+    productUsage: Array<{
+        productId: string;
+        productName: string;
+        brandName: string;
+        totalQuantity: number;
+        totalRevenue: number;
+        usageCount: number;
+    }>;
+}
+/**
+ * Time Efficiency Metrics
+ * Analysis of booked time vs actual time spent
+ */
+interface TimeEfficiencyMetrics {
+    totalAppointments: number;
+    appointmentsWithActualTime: number;
+    averageBookedDuration: number;
+    averageActualDuration: number;
+    averageEfficiency: number;
+    totalOverrun: number;
+    totalUnderutilization: number;
+    averageOverrun: number;
+    averageUnderutilization: number;
+    efficiencyDistribution: Array<{
+        range: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Cancellation Metrics
+ * Analysis of appointment cancellations
+ */
+interface CancellationMetrics {
+    entityId: string;
+    entityName: string;
+    entityType: EntityType;
+    totalAppointments: number;
+    canceledAppointments: number;
+    cancellationRate: number;
+    canceledByPatient: number;
+    canceledByClinic: number;
+    canceledByPractitioner: number;
+    canceledRescheduled: number;
+    averageCancellationLeadTime: number;
+    cancellationReasons: Array<{
+        reason: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+/**
+ * No-Show Metrics
+ * Analysis of appointment no-shows
+ */
+interface NoShowMetrics {
+    entityId: string;
+    entityName: string;
+    entityType: EntityType;
+    totalAppointments: number;
+    noShowAppointments: number;
+    noShowRate: number;
+}
+/**
+ * Revenue Metrics
+ * Financial analysis and revenue tracking
+ */
+interface RevenueMetrics {
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    totalAppointments: number;
+    completedAppointments: number;
+    currency: string;
+    revenueByStatus: Partial<Record<AppointmentStatus, number>>;
+    revenueByPaymentStatus: Partial<Record<PaymentStatus, number>>;
+    unpaidRevenue: number;
+    refundedRevenue: number;
+    totalTax: number;
+    totalSubtotal: number;
+}
+/**
+ * Revenue Trend
+ * Revenue data over time
+ */
+interface RevenueTrend {
+    period: string;
+    startDate: Date;
+    endDate: Date;
+    revenue: number;
+    appointmentCount: number;
+    averageRevenue: number;
+}
+/**
+ * Duration Trend
+ * Appointment duration trends over time
+ */
+interface DurationTrend {
+    period: string;
+    startDate: Date;
+    endDate: Date;
+    averageBookedDuration: number;
+    averageActualDuration: number;
+    averageEfficiency: number;
+    appointmentCount: number;
+}
+/**
+ * Product Usage Metrics
+ * Analysis of product usage in appointments
+ */
+interface ProductUsageMetrics {
+    productId: string;
+    productName: string;
+    brandId: string;
+    brandName: string;
+    totalQuantity: number;
+    totalRevenue: number;
+    averagePrice: number;
+    currency: string;
+    usageCount: number;
+    averageQuantityPerAppointment: number;
+    usageByProcedure: Array<{
+        procedureId: string;
+        procedureName: string;
+        count: number;
+        totalQuantity: number;
+    }>;
+}
+/**
+ * Product Revenue Metrics
+ * Revenue contribution by product
+ */
+interface ProductRevenueMetrics {
+    productId: string;
+    productName: string;
+    brandName: string;
+    totalRevenue: number;
+    currency: string;
+    usageCount: number;
+    averageRevenuePerUsage: number;
+}
+/**
+ * Product Usage by Procedure
+ * Product usage patterns for specific procedures
+ */
+interface ProductUsageByProcedure {
+    procedureId: string;
+    procedureName: string;
+    products: Array<{
+        productId: string;
+        productName: string;
+        brandName: string;
+        totalQuantity: number;
+        totalRevenue: number;
+        usageCount: number;
+    }>;
+}
+/**
+ * Patient Analytics
+ * Comprehensive patient metrics
+ */
+interface PatientAnalytics {
+    patientId: string;
+    patientName: string;
+    totalAppointments: number;
+    completedAppointments: number;
+    canceledAppointments: number;
+    noShowAppointments: number;
+    cancellationRate: number;
+    noShowRate: number;
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    currency: string;
+    lifetimeValue: number;
+    firstAppointmentDate: Date | null;
+    lastAppointmentDate: Date | null;
+    averageDaysBetweenAppointments: number | null;
+    uniquePractitioners: number;
+    uniqueClinics: number;
+    favoriteProcedures: Array<{
+        procedureId: string;
+        procedureName: string;
+        count: number;
+    }>;
+}
+/**
+ * Patient Lifetime Value Metrics
+ * Patient value analysis
+ */
+interface PatientLifetimeValueMetrics {
+    totalPatients: number;
+    averageLifetimeValue: number;
+    currency: string;
+    topPatients: Array<{
+        patientId: string;
+        patientName: string;
+        lifetimeValue: number;
+        appointmentCount: number;
+    }>;
+    valueDistribution: Array<{
+        range: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Patient Retention Metrics
+ * Patient retention and return analysis
+ */
+interface PatientRetentionMetrics {
+    totalPatients: number;
+    newPatients: number;
+    returningPatients: number;
+    retentionRate: number;
+    averageAppointmentsPerPatient: number;
+    patientsByAppointmentCount: Array<{
+        appointmentCount: number;
+        patientCount: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Cost Per Patient Metrics
+ * Cost analysis per patient
+ */
+interface CostPerPatientMetrics {
+    totalPatients: number;
+    totalRevenue: number;
+    averageCostPerPatient: number;
+    currency: string;
+    costDistribution: Array<{
+        range: string;
+        patientCount: number;
+        percentage: number;
+    }>;
+    patientCosts?: Array<{
+        patientId: string;
+        patientName: string;
+        totalCost: number;
+        appointmentCount: number;
+        averageCost: number;
+    }>;
+}
+/**
+ * Payment Status Breakdown
+ * Analysis of payment statuses
+ */
+interface PaymentStatusBreakdown {
+    totalAppointments: number;
+    byStatus: Partial<Record<PaymentStatus, {
+        count: number;
+        percentage: number;
+        totalRevenue: number;
+    }>>;
+    unpaidCount: number;
+    unpaidRevenue: number;
+    paidCount: number;
+    paidRevenue: number;
+    partiallyPaidCount: number;
+    partiallyPaidRevenue: number;
+    refundedCount: number;
+    refundedRevenue: number;
+}
+/**
+ * Clinic Analytics
+ * Comprehensive clinic performance metrics
+ */
+interface ClinicAnalytics {
+    clinicBranchId: string;
+    clinicName: string;
+    totalAppointments: number;
+    completedAppointments: number;
+    canceledAppointments: number;
+    noShowAppointments: number;
+    cancellationRate: number;
+    noShowRate: number;
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    currency: string;
+    practitionerCount: number;
+    patientCount: number;
+    procedureCount: number;
+    topPractitioners: Array<{
+        practitionerId: string;
+        practitionerName: string;
+        appointmentCount: number;
+        revenue: number;
+    }>;
+    topProcedures: Array<{
+        procedureId: string;
+        procedureName: string;
+        appointmentCount: number;
+        revenue: number;
+    }>;
+}
+/**
+ * Clinic Comparison Metrics
+ * Comparison data for multiple clinics
+ */
+interface ClinicComparisonMetrics {
+    clinicBranchId: string;
+    clinicName: string;
+    totalAppointments: number;
+    completedAppointments: number;
+    cancellationRate: number;
+    noShowRate: number;
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    practitionerCount: number;
+    patientCount: number;
+    efficiency: number;
+}
+/**
+ * Procedure Popularity
+ * Popularity metrics for procedures
+ */
+interface ProcedurePopularity {
+    procedureId: string;
+    procedureName: string;
+    categoryName: string;
+    subcategoryName: string;
+    technologyName: string;
+    appointmentCount: number;
+    completedCount: number;
+    rank: number;
+}
+/**
+ * Procedure Profitability
+ * Profitability metrics for procedures
+ */
+interface ProcedureProfitability {
+    procedureId: string;
+    procedureName: string;
+    categoryName: string;
+    subcategoryName: string;
+    technologyName: string;
+    totalRevenue: number;
+    averageRevenue: number;
+    appointmentCount: number;
+    rank: number;
+}
+/**
+ * Cancellation Reason Statistics
+ * Breakdown of cancellation reasons
+ */
+interface CancellationReasonStats {
+    reason: string;
+    count: number;
+    percentage: number;
+    averageLeadTime: number;
+}
+/**
+ * Dashboard Analytics
+ * Comprehensive dashboard data aggregation
+ */
+interface DashboardAnalytics {
+    overview: {
+        totalAppointments: number;
+        completedAppointments: number;
+        canceledAppointments: number;
+        noShowAppointments: number;
+        pendingAppointments: number;
+        confirmedAppointments: number;
+        totalRevenue: number;
+        averageRevenuePerAppointment: number;
+        currency: string;
+        uniquePatients: number;
+        uniquePractitioners: number;
+        uniqueProcedures: number;
+        cancellationRate: number;
+        noShowRate: number;
+    };
+    practitionerMetrics: PractitionerAnalytics[];
+    procedureMetrics: ProcedureAnalytics[];
+    cancellationMetrics: CancellationMetrics;
+    noShowMetrics: NoShowMetrics;
+    revenueTrends: RevenueTrend[];
+    timeEfficiency: TimeEfficiencyMetrics;
+    topProducts: ProductUsageMetrics[];
+    recentActivity: Array<{
+        type: 'appointment' | 'cancellation' | 'completion' | 'no_show';
+        date: Date;
+        description: string;
+        entityId?: string;
+        entityName?: string;
+    }>;
+}
+
+/**
+ * Period type for analytics snapshots
+ */
+type AnalyticsPeriod = 'daily' | 'weekly' | 'monthly' | 'yearly' | 'all_time';
+/**
+ * Analytics document metadata
+ */
+interface AnalyticsMetadata {
+    clinicBranchId: string;
+    period: AnalyticsPeriod;
+    periodStart: Date;
+    periodEnd: Date;
+    computedAt: Timestamp;
+    computedBy: 'cloud_function' | 'manual';
+    version: string;
+}
+/**
+ * Stored Practitioner Analytics
+ * Stored in: clinics/{clinicBranchId}/analytics/practitioners/{practitionerId}/{period}
+ */
+interface StoredPractitionerAnalytics extends PractitionerAnalytics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Procedure Analytics
+ * Stored in: clinics/{clinicBranchId}/analytics/procedures/{procedureId}/{period}
+ */
+interface StoredProcedureAnalytics extends ProcedureAnalytics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Clinic Analytics
+ * Stored in: clinics/{clinicBranchId}/analytics/clinic/{period}
+ */
+interface StoredClinicAnalytics extends ClinicAnalytics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Dashboard Analytics
+ * Stored in: clinics/{clinicBranchId}/analytics/dashboard/{period}
+ */
+interface StoredDashboardAnalytics extends DashboardAnalytics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Time Efficiency Metrics
+ * Stored in: clinics/{clinicBranchId}/analytics/time_efficiency/{period}
+ */
+interface StoredTimeEfficiencyMetrics extends TimeEfficiencyMetrics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Cancellation Metrics
+ * Stored in: clinics/{clinicBranchId}/analytics/cancellations/{entityType}/{period}
+ */
+interface StoredCancellationMetrics extends CancellationMetrics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored No-Show Metrics
+ * Stored in: clinics/{clinicBranchId}/analytics/no_shows/{entityType}/{period}
+ */
+interface StoredNoShowMetrics extends NoShowMetrics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Stored Revenue Metrics
+ * Stored in: clinics/{clinicBranchId}/analytics/revenue/{period}
+ */
+interface StoredRevenueMetrics extends RevenueMetrics {
+    metadata: AnalyticsMetadata;
+}
+/**
+ * Collection names for stored analytics
+ */
+declare const ANALYTICS_COLLECTION = "analytics";
+declare const PRACTITIONER_ANALYTICS_SUBCOLLECTION = "practitioners";
+declare const PROCEDURE_ANALYTICS_SUBCOLLECTION = "procedures";
+declare const CLINIC_ANALYTICS_SUBCOLLECTION = "clinic";
+declare const DASHBOARD_ANALYTICS_SUBCOLLECTION = "dashboard";
+declare const TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION = "time_efficiency";
+declare const CANCELLATION_ANALYTICS_SUBCOLLECTION = "cancellations";
+declare const NO_SHOW_ANALYTICS_SUBCOLLECTION = "no_shows";
+declare const REVENUE_ANALYTICS_SUBCOLLECTION = "revenue";
+/**
+ * Options for reading stored analytics
+ */
+interface ReadStoredAnalyticsOptions {
+    /**
+     * Whether to use cached/pre-computed data
+     * @default true
+     */
+    useCache?: boolean;
+    /**
+     * Maximum age of cached data in hours before recalculating
+     * @default 12
+     */
+    maxCacheAgeHours?: number;
+    /**
+     * Period to read
+     * @default 'all_time'
+     */
+    period?: AnalyticsPeriod;
+    /**
+     * Date range for the period (calculated if not provided)
+     */
+    dateRange?: AnalyticsDateRange;
+    /**
+     * Clinic branch ID (required for reading stored analytics)
+     */
+    clinicBranchId?: string;
+}
+
+/**
+ * Base interface for grouped analytics results
+ * All grouped analytics share common entity identification
+ */
+interface GroupedAnalyticsBase {
+    entityId: string;
+    entityName: string;
+    entityType: EntityType;
+}
+/**
+ * Grouped Revenue Metrics
+ * Revenue analytics grouped by clinic, practitioner, procedure, or patient
+ */
+interface GroupedRevenueMetrics extends GroupedAnalyticsBase {
+    totalRevenue: number;
+    averageRevenuePerAppointment: number;
+    totalAppointments: number;
+    completedAppointments: number;
+    currency: string;
+    unpaidRevenue: number;
+    refundedRevenue: number;
+    totalTax: number;
+    totalSubtotal: number;
+}
+/**
+ * Grouped Product Usage Metrics
+ * Product usage analytics grouped by clinic, practitioner, procedure, or patient
+ */
+interface GroupedProductUsageMetrics extends GroupedAnalyticsBase {
+    totalProductsUsed: number;
+    uniqueProducts: number;
+    totalProductRevenue: number;
+    totalProductQuantity: number;
+    averageProductsPerAppointment: number;
+    topProducts: Array<{
+        productId: string;
+        productName: string;
+        brandName: string;
+        totalQuantity: number;
+        totalRevenue: number;
+        usageCount: number;
+    }>;
+}
+/**
+ * Grouped Patient Retention Metrics
+ * Patient retention analytics grouped by clinic, practitioner, or procedure
+ */
+interface GroupedPatientRetentionMetrics extends GroupedAnalyticsBase {
+    totalPatients: number;
+    newPatients: number;
+    returningPatients: number;
+    retentionRate: number;
+    averageAppointmentsPerPatient: number;
+    patientsByAppointmentCount: Array<{
+        appointmentCount: number;
+        patientCount: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Grouped Time Efficiency Metrics
+ * Time efficiency analytics grouped by clinic, practitioner, procedure, or patient
+ */
+interface GroupedTimeEfficiencyMetrics extends GroupedAnalyticsBase {
+    totalAppointments: number;
+    appointmentsWithActualTime: number;
+    averageBookedDuration: number;
+    averageActualDuration: number;
+    averageEfficiency: number;
+    totalOverrun: number;
+    totalUnderutilization: number;
+    averageOverrun: number;
+    averageUnderutilization: number;
+}
+/**
+ * Grouped Patient Behavior Metrics
+ * Patient behavior (no-show, cancellation) grouped by clinic, practitioner, or procedure
+ */
+interface GroupedPatientBehaviorMetrics extends GroupedAnalyticsBase {
+    totalPatients: number;
+    patientsWithNoShows: number;
+    patientsWithCancellations: number;
+    averageNoShowRate: number;
+    averageCancellationRate: number;
+    topNoShowPatients: Array<{
+        patientId: string;
+        patientName: string;
+        noShowCount: number;
+        totalAppointments: number;
+        noShowRate: number;
+    }>;
+    topCancellationPatients: Array<{
+        patientId: string;
+        patientName: string;
+        cancellationCount: number;
+        totalAppointments: number;
+        cancellationRate: number;
+    }>;
+}
+/**
+ * Grouped Procedure Performance Metrics
+ * Procedure performance grouped by clinic or practitioner
+ */
+interface GroupedProcedurePerformanceMetrics extends GroupedAnalyticsBase {
+    totalProcedures: number;
+    totalAppointments: number;
+    completedAppointments: number;
+    totalRevenue: number;
+    averageRevenuePerProcedure: number;
+    topProcedures: Array<{
+        procedureId: string;
+        procedureName: string;
+        appointmentCount: number;
+        revenue: number;
+        cancellationRate: number;
+        noShowRate: number;
+    }>;
+}
+/**
+ * Grouped Practitioner Performance Metrics
+ * Practitioner performance grouped by clinic
+ */
+interface GroupedPractitionerPerformanceMetrics extends GroupedAnalyticsBase {
+    totalPractitioners: number;
+    totalAppointments: number;
+    completedAppointments: number;
+    totalRevenue: number;
+    averageRevenuePerPractitioner: number;
+    topPractitioners: Array<{
+        practitionerId: string;
+        practitionerName: string;
+        appointmentCount: number;
+        revenue: number;
+        cancellationRate: number;
+        noShowRate: number;
+        timeEfficiency: number;
+    }>;
+}
+
 /**
  * Enumeracija koja definiše sve moguće tipove notifikacija
  */
@@ -2053,6 +2781,7 @@ declare enum NotificationType {
     FORM_REMINDER = "formReminder",// Reminds user to fill a specific form
     FORM_SUBMISSION_CONFIRMATION = "formSubmissionConfirmation",// Confirms form was submitted
     REVIEW_REQUEST = "reviewRequest",// Request for patient review post-appointment
+    PROCEDURE_RECOMMENDATION = "procedureRecommendation",// Doctor recommended a procedure for follow-up
     PAYMENT_DUE = "paymentDue",
     PAYMENT_CONFIRMATION = "paymentConfirmation",
     PAYMENT_FAILED = "paymentFailed",
@@ -2222,6 +2951,24 @@ interface ReviewRequestNotification extends BaseNotification {
     practitionerName?: string;
     procedureName?: string;
 }
+/**
+ * Notification for when a doctor recommends a procedure for follow-up.
+ * Example: "Dr. Smith recommended [Procedure Name] for you. Suggested timeframe: in 2 weeks"
+ */
+interface ProcedureRecommendationNotification extends BaseNotification {
+    notificationType: NotificationType.PROCEDURE_RECOMMENDATION;
+    appointmentId: string;
+    recommendationId: string;
+    procedureId: string;
+    procedureName: string;
+    practitionerName: string;
+    clinicName: string;
+    note?: string;
+    timeframe: {
+        value: number;
+        unit: 'day' | 'week' | 'month' | 'year';
+    };
+}
 /**
  * Generic notification for direct messages or announcements.
  */
@@ -2237,7 +2984,7 @@ interface PaymentConfirmationNotification extends BaseNotification {
 /**
  * Unija svih tipova notifikacija
  */
-type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | GeneralMessageNotification | PaymentConfirmationNotification;
+type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | ProcedureRecommendationNotification | GeneralMessageNotification | PaymentConfirmationNotification;
 
 /**
  * Minimal interface for the new mailgun.js client's messages API
@@ -2676,6 +3423,20 @@ declare class AppointmentAggregationService {
      * @param after - The appointment state after update
      */
     private handleZonePhotosUpdate;
+    /**
+     * Checks if recommended procedures have changed between two appointment states
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @returns True if recommendations have changed, false otherwise
+     */
+    private hasRecommendationsChanged;
+    /**
+     * Handles recommended procedures update - creates notifications for newly added recommendations
+     * @param before - The appointment state before update
+     * @param after - The appointment state after update
+     * @param patientProfile - The patient profile (for expo tokens)
+     */
+    private handleRecommendedProceduresUpdate;
 }
 
 /**
@@ -3175,6 +3936,44 @@ declare class ReviewsAggregationService {
     calculateEntityReviewInfo(entityId: string, entityType: "clinic" | "practitioner" | "procedure"): Promise<ClinicReviewInfo | PractitionerReviewInfo | ProcedureReviewInfo>;
 }
 
+/**
+ * Admin version of AnalyticsService that uses Firebase Admin SDK
+ * This is intended for use in Cloud Functions and server-side code
+ */
+declare class AnalyticsAdminService {
+    private analyticsService;
+    private db;
+    /**
+     * Creates a new AnalyticsAdminService instance
+     *
+     * @param firestore - Admin Firestore instance (optional, defaults to admin.firestore())
+     */
+    constructor(firestore?: admin.firestore.Firestore);
+    /**
+     * Creates an adapter for AppointmentService to work with admin SDK
+     */
+    private createAppointmentServiceAdapter;
+    getPractitionerAnalytics(practitionerId: string, dateRange?: AnalyticsDateRange, options?: any): Promise<PractitionerAnalytics>;
+    getProcedureAnalytics(procedureId?: string, dateRange?: AnalyticsDateRange, options?: any): Promise<ProcedureAnalytics | ProcedureAnalytics[]>;
+    getTimeEfficiencyMetrics(filters?: AnalyticsFilters, dateRange?: AnalyticsDateRange, options?: any): Promise<TimeEfficiencyMetrics>;
+    getTimeEfficiencyMetricsByEntity(groupBy: EntityType, dateRange?: AnalyticsDateRange, filters?: AnalyticsFilters): Promise<GroupedTimeEfficiencyMetrics[]>;
+    getCancellationMetrics(groupBy: EntityType, dateRange?: AnalyticsDateRange, options?: any): Promise<CancellationMetrics | CancellationMetrics[]>;
+    getNoShowMetrics(groupBy: EntityType, dateRange?: AnalyticsDateRange, options?: any): Promise<NoShowMetrics | NoShowMetrics[]>;
+    getRevenueMetrics(filters?: AnalyticsFilters, dateRange?: AnalyticsDateRange, options?: any): Promise<RevenueMetrics>;
+    getRevenueMetricsByEntity(groupBy: EntityType, dateRange?: AnalyticsDateRange, filters?: AnalyticsFilters): Promise<GroupedRevenueMetrics[]>;
+    getProductUsageMetrics(productId?: string, dateRange?: AnalyticsDateRange): Promise<ProductUsageMetrics | ProductUsageMetrics[]>;
+    getProductUsageMetricsByEntity(groupBy: EntityType, dateRange?: AnalyticsDateRange, filters?: AnalyticsFilters): Promise<GroupedProductUsageMetrics[]>;
+    getPatientAnalytics(patientId?: string, dateRange?: AnalyticsDateRange): Promise<PatientAnalytics | PatientAnalytics[]>;
+    getPatientBehaviorMetricsByEntity(groupBy: 'clinic' | 'practitioner' | 'procedure' | 'technology', dateRange?: AnalyticsDateRange, filters?: AnalyticsFilters): Promise<GroupedPatientBehaviorMetrics[]>;
+    getClinicAnalytics(clinicBranchId: string, dateRange?: AnalyticsDateRange): Promise<ClinicAnalytics | ClinicAnalytics[]>;
+    getDashboardData(filters?: AnalyticsFilters, dateRange?: AnalyticsDateRange, options?: any): Promise<DashboardAnalytics>;
+    /**
+     * Expose fetchAppointments for direct access if needed
+     * This method is used internally by AnalyticsService
+     */
+    fetchAppointments(filters?: AnalyticsFilters, dateRange?: AnalyticsDateRange): Promise<any[]>;
+}
+
 /**
  * Request parameters for calculating available booking slots
  */
@@ -3766,4 +4565,4 @@ declare class UserProfileAdminService {
     initializePractitionerRole(userId: string): Promise<User>;
 }
 
-export { type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CalendarAdminService, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicInfo, type ClinicLocation, type CreateBillingTransactionData, 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 PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureSummaryInfo, type RequirementSourceProcedure, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type StripeTransactionData, SubscriptionStatus, type TimeInterval, UserProfileAdminService, UserRole, freeConsultationInfrastructure };
+export { ANALYTICS_COLLECTION, AnalyticsAdminService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AvailableSlot, BaseMailingService, type BaseMetrics, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CalendarAdminService, type CancellationMetrics, type CancellationReasonStats, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicAnalytics, type ClinicComparisonMetrics, type ClinicInfo, type ClinicLocation, type CostPerPatientMetrics, type CreateBillingTransactionData, DASHBOARD_ANALYTICS_SUBCOLLECTION, type DashboardAnalytics, type DoctorInfo, DocumentManagerAdminService, type DurationTrend, type EntityType, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NewMailgunClient$2 as NewMailgunClient, type NoShowMetrics, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type PatientProfile as Patient, PatientAggregationService, type PatientAnalytics, PatientInstructionStatus, type PatientLifetimeValueMetrics, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientRetentionMetrics, type PatientSensitiveInfo, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerAnalytics, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureAnalytics, type ProcedurePopularity, type ProcedureProfitability, type ProcedureSummaryInfo, type ProductRevenueMetrics, type ProductUsageByProcedure, type ProductUsageMetrics, REVENUE_ANALYTICS_SUBCOLLECTION, type ReadStoredAnalyticsOptions, type RequirementSourceProcedure, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAddedEmailData, type ReviewRequestEmailData, ReviewsAggregationService, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, SubscriptionStatus, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type TimeEfficiencyMetrics, type TimeInterval, UserProfileAdminService, UserRole, freeConsultationInfrastructure };