@blackcode_sa/metaestetics-api 1.13.3 → 1.13.5

package/src/admin/analytics/analytics.admin.service.ts

@@ -1,278 +1,278 @@
-import * as admin from 'firebase-admin';
-import { AnalyticsService } from '../../services/analytics/analytics.service';
-import {
-  AnalyticsDateRange,
-  AnalyticsFilters,
-  EntityType,
-} from '../../types/analytics';
-import {
-  PractitionerAnalytics,
-  ProcedureAnalytics,
-  TimeEfficiencyMetrics,
-  CancellationMetrics,
-  NoShowMetrics,
-  RevenueMetrics,
-  ProductUsageMetrics,
-  PatientAnalytics,
-  ClinicAnalytics,
-  DashboardAnalytics,
-  GroupedRevenueMetrics,
-  GroupedProductUsageMetrics,
-  GroupedTimeEfficiencyMetrics,
-  GroupedPatientBehaviorMetrics,
-} from '../../types/analytics';
-import { Appointment } from '../../types/appointment';
-import { APPOINTMENTS_COLLECTION } from '../../types/appointment';
-
-/**
- * Admin version of AnalyticsService that uses Firebase Admin SDK
- * This is intended for use in Cloud Functions and server-side code
- */
-export class AnalyticsAdminService {
-  private analyticsService: AnalyticsService;
-  private db: admin.firestore.Firestore;
-
-  /**
-   * Creates a new AnalyticsAdminService instance
-   *
-   * @param firestore - Admin Firestore instance (optional, defaults to admin.firestore())
-   */
-  constructor(firestore?: admin.firestore.Firestore) {
-    this.db = firestore || admin.firestore();
-    
-    // Create a mock Firebase App for client SDK compatibility
-    const mockApp = {
-      name: '[DEFAULT]',
-      options: {},
-      automaticDataCollectionEnabled: false,
-    } as any;
-
-    // Create mock Auth (not used by AnalyticsService)
-    const mockAuth = {} as any;
-
-    // Create AppointmentService adapter that uses admin SDK
-    const appointmentService = this.createAppointmentServiceAdapter();
-
-    // Initialize AnalyticsService with adapted dependencies
-    this.analyticsService = new AnalyticsService(
-      this.db as any, // Cast admin Firestore to client Firestore type
-      mockAuth,
-      mockApp,
-      appointmentService,
-    );
-  }
-
-  /**
-   * Creates an adapter for AppointmentService to work with admin SDK
-   */
-  private createAppointmentServiceAdapter(): any {
-    return {
-      searchAppointments: async (params: any) => {
-        // Build query using admin SDK
-        let query: admin.firestore.Query = this.db.collection(APPOINTMENTS_COLLECTION);
-
-        if (params.clinicBranchId) {
-          query = query.where('clinicBranchId', '==', params.clinicBranchId);
-        }
-        if (params.practitionerId) {
-          query = query.where('practitionerId', '==', params.practitionerId);
-        }
-        if (params.procedureId) {
-          query = query.where('procedureId', '==', params.procedureId);
-        }
-        if (params.patientId) {
-          query = query.where('patientId', '==', params.patientId);
-        }
-        if (params.startDate) {
-          const startDate = params.startDate instanceof Date 
-            ? params.startDate 
-            : params.startDate.toDate();
-          const startTimestamp = admin.firestore.Timestamp.fromDate(startDate);
-          query = query.where('appointmentStartTime', '>=', startTimestamp);
-        }
-        if (params.endDate) {
-          const endDate = params.endDate instanceof Date 
-            ? params.endDate 
-            : params.endDate.toDate();
-          const endTimestamp = admin.firestore.Timestamp.fromDate(endDate);
-          query = query.where('appointmentStartTime', '<=', endTimestamp);
-        }
-
-        const snapshot = await query.get();
-        const appointments = snapshot.docs.map(doc => ({
-          id: doc.id,
-          ...doc.data(),
-        })) as Appointment[];
-
-        return {
-          appointments,
-          total: appointments.length,
-        };
-      },
-    };
-  }
-
-  // Delegate all methods to the underlying AnalyticsService
-  // We expose them here so they can be called with admin SDK context
-
-  async getPractitionerAnalytics(
-    practitionerId: string,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<PractitionerAnalytics> {
-    return this.analyticsService.getPractitionerAnalytics(practitionerId, dateRange, options);
-  }
-
-  async getProcedureAnalytics(
-    procedureId?: string,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<ProcedureAnalytics | ProcedureAnalytics[]> {
-    return this.analyticsService.getProcedureAnalytics(procedureId, dateRange, options);
-  }
-
-  async getTimeEfficiencyMetrics(
-    filters?: AnalyticsFilters,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<TimeEfficiencyMetrics> {
-    return this.analyticsService.getTimeEfficiencyMetrics(filters, dateRange, options);
-  }
-
-  async getTimeEfficiencyMetricsByEntity(
-    groupBy: EntityType,
-    dateRange?: AnalyticsDateRange,
-    filters?: AnalyticsFilters,
-  ): Promise<GroupedTimeEfficiencyMetrics[]> {
-    return this.analyticsService.getTimeEfficiencyMetricsByEntity(groupBy, dateRange, filters);
-  }
-
-  async getCancellationMetrics(
-    groupBy: EntityType,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<CancellationMetrics | CancellationMetrics[]> {
-    return this.analyticsService.getCancellationMetrics(groupBy, dateRange, options);
-  }
-
-  async getNoShowMetrics(
-    groupBy: EntityType,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<NoShowMetrics | NoShowMetrics[]> {
-    return this.analyticsService.getNoShowMetrics(groupBy, dateRange, options);
-  }
-
-  async getRevenueMetrics(
-    filters?: AnalyticsFilters,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<RevenueMetrics> {
-    return this.analyticsService.getRevenueMetrics(filters, dateRange, options);
-  }
-
-  async getRevenueMetricsByEntity(
-    groupBy: EntityType,
-    dateRange?: AnalyticsDateRange,
-    filters?: AnalyticsFilters,
-  ): Promise<GroupedRevenueMetrics[]> {
-    return this.analyticsService.getRevenueMetricsByEntity(groupBy, dateRange, filters);
-  }
-
-  async getProductUsageMetrics(
-    productId?: string,
-    dateRange?: AnalyticsDateRange,
-  ): Promise<ProductUsageMetrics | ProductUsageMetrics[]> {
-    return this.analyticsService.getProductUsageMetrics(productId, dateRange);
-  }
-
-  async getProductUsageMetricsByEntity(
-    groupBy: EntityType,
-    dateRange?: AnalyticsDateRange,
-    filters?: AnalyticsFilters,
-  ): Promise<GroupedProductUsageMetrics[]> {
-    return this.analyticsService.getProductUsageMetricsByEntity(groupBy, dateRange, filters);
-  }
-
-  async getPatientAnalytics(
-    patientId?: string,
-    dateRange?: AnalyticsDateRange,
-  ): Promise<PatientAnalytics | PatientAnalytics[]> {
-    return this.analyticsService.getPatientAnalytics(patientId, dateRange);
-  }
-
-  async getPatientBehaviorMetricsByEntity(
-    groupBy: 'clinic' | 'practitioner' | 'procedure' | 'technology',
-    dateRange?: AnalyticsDateRange,
-    filters?: AnalyticsFilters,
-  ): Promise<GroupedPatientBehaviorMetrics[]> {
-    return this.analyticsService.getPatientBehaviorMetricsByEntity(groupBy, dateRange, filters);
-  }
-
-  async getClinicAnalytics(
-    clinicBranchId: string,
-    dateRange?: AnalyticsDateRange,
-  ): Promise<ClinicAnalytics | ClinicAnalytics[]> {
-    // Use getDashboardData to get clinic-level analytics
-    const dashboard = await this.analyticsService.getDashboardData(
-      { clinicBranchId },
-      dateRange,
-    );
-    
-    // Get clinic info
-    const clinicDoc = await this.db.collection('clinics').doc(clinicBranchId).get();
-    const clinicData = clinicDoc.data();
-    const clinicName = clinicData?.name || 'Unknown';
-    
-    // Convert DashboardAnalytics to ClinicAnalytics format
-    return {
-      clinicBranchId,
-      clinicName,
-      totalAppointments: dashboard.overview.totalAppointments,
-      completedAppointments: dashboard.overview.completedAppointments,
-      canceledAppointments: dashboard.overview.canceledAppointments,
-      noShowAppointments: dashboard.overview.noShowAppointments,
-      cancellationRate: dashboard.overview.cancellationRate,
-      noShowRate: dashboard.overview.noShowRate,
-      totalRevenue: dashboard.overview.totalRevenue,
-      averageRevenuePerAppointment: dashboard.overview.averageRevenuePerAppointment,
-      currency: dashboard.overview.currency,
-      practitionerCount: dashboard.overview.uniquePractitioners,
-      patientCount: dashboard.overview.uniquePatients,
-      procedureCount: dashboard.overview.uniqueProcedures,
-      topPractitioners: dashboard.practitionerMetrics.slice(0, 5).map(p => ({
-        practitionerId: p.practitionerId,
-        practitionerName: p.practitionerName,
-        appointmentCount: p.totalAppointments,
-        revenue: p.totalRevenue,
-      })),
-      topProcedures: dashboard.procedureMetrics.slice(0, 5).map(p => ({
-        procedureId: p.procedureId,
-        procedureName: p.procedureName,
-        appointmentCount: p.totalAppointments,
-        revenue: p.totalRevenue,
-      })),
-    };
-  }
-
-  async getDashboardData(
-    filters?: AnalyticsFilters,
-    dateRange?: AnalyticsDateRange,
-    options?: any,
-  ): Promise<DashboardAnalytics> {
-    return this.analyticsService.getDashboardData(filters, dateRange, options);
-  }
-
-  /**
-   * Expose fetchAppointments for direct access if needed
-   * This method is used internally by AnalyticsService
-   */
-  async fetchAppointments(
-    filters?: AnalyticsFilters,
-    dateRange?: AnalyticsDateRange,
-  ): Promise<any[]> {
-    // Access the private method via the service
-    return (this.analyticsService as any).fetchAppointments(filters, dateRange);
-  }
-}
-
+import * as admin from 'firebase-admin';
+import { AnalyticsService } from '../../services/analytics/analytics.service';
+import {
+  AnalyticsDateRange,
+  AnalyticsFilters,
+  EntityType,
+} from '../../types/analytics';
+import {
+  PractitionerAnalytics,
+  ProcedureAnalytics,
+  TimeEfficiencyMetrics,
+  CancellationMetrics,
+  NoShowMetrics,
+  RevenueMetrics,
+  ProductUsageMetrics,
+  PatientAnalytics,
+  ClinicAnalytics,
+  DashboardAnalytics,
+  GroupedRevenueMetrics,
+  GroupedProductUsageMetrics,
+  GroupedTimeEfficiencyMetrics,
+  GroupedPatientBehaviorMetrics,
+} from '../../types/analytics';
+import { Appointment } from '../../types/appointment';
+import { APPOINTMENTS_COLLECTION } from '../../types/appointment';
+
+/**
+ * Admin version of AnalyticsService that uses Firebase Admin SDK
+ * This is intended for use in Cloud Functions and server-side code
+ */
+export class AnalyticsAdminService {
+  private analyticsService: AnalyticsService;
+  private db: admin.firestore.Firestore;
+
+  /**
+   * Creates a new AnalyticsAdminService instance
+   *
+   * @param firestore - Admin Firestore instance (optional, defaults to admin.firestore())
+   */
+  constructor(firestore?: admin.firestore.Firestore) {
+    this.db = firestore || admin.firestore();
+    
+    // Create a mock Firebase App for client SDK compatibility
+    const mockApp = {
+      name: '[DEFAULT]',
+      options: {},
+      automaticDataCollectionEnabled: false,
+    } as any;
+
+    // Create mock Auth (not used by AnalyticsService)
+    const mockAuth = {} as any;
+
+    // Create AppointmentService adapter that uses admin SDK
+    const appointmentService = this.createAppointmentServiceAdapter();
+
+    // Initialize AnalyticsService with adapted dependencies
+    this.analyticsService = new AnalyticsService(
+      this.db as any, // Cast admin Firestore to client Firestore type
+      mockAuth,
+      mockApp,
+      appointmentService,
+    );
+  }
+
+  /**
+   * Creates an adapter for AppointmentService to work with admin SDK
+   */
+  private createAppointmentServiceAdapter(): any {
+    return {
+      searchAppointments: async (params: any) => {
+        // Build query using admin SDK
+        let query: admin.firestore.Query = this.db.collection(APPOINTMENTS_COLLECTION);
+
+        if (params.clinicBranchId) {
+          query = query.where('clinicBranchId', '==', params.clinicBranchId);
+        }
+        if (params.practitionerId) {
+          query = query.where('practitionerId', '==', params.practitionerId);
+        }
+        if (params.procedureId) {
+          query = query.where('procedureId', '==', params.procedureId);
+        }
+        if (params.patientId) {
+          query = query.where('patientId', '==', params.patientId);
+        }
+        if (params.startDate) {
+          const startDate = params.startDate instanceof Date 
+            ? params.startDate 
+            : params.startDate.toDate();
+          const startTimestamp = admin.firestore.Timestamp.fromDate(startDate);
+          query = query.where('appointmentStartTime', '>=', startTimestamp);
+        }
+        if (params.endDate) {
+          const endDate = params.endDate instanceof Date 
+            ? params.endDate 
+            : params.endDate.toDate();
+          const endTimestamp = admin.firestore.Timestamp.fromDate(endDate);
+          query = query.where('appointmentStartTime', '<=', endTimestamp);
+        }
+
+        const snapshot = await query.get();
+        const appointments = snapshot.docs.map(doc => ({
+          id: doc.id,
+          ...doc.data(),
+        })) as Appointment[];
+
+        return {
+          appointments,
+          total: appointments.length,
+        };
+      },
+    };
+  }
+
+  // Delegate all methods to the underlying AnalyticsService
+  // We expose them here so they can be called with admin SDK context
+
+  async getPractitionerAnalytics(
+    practitionerId: string,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<PractitionerAnalytics> {
+    return this.analyticsService.getPractitionerAnalytics(practitionerId, dateRange, options);
+  }
+
+  async getProcedureAnalytics(
+    procedureId?: string,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<ProcedureAnalytics | ProcedureAnalytics[]> {
+    return this.analyticsService.getProcedureAnalytics(procedureId, dateRange, options);
+  }
+
+  async getTimeEfficiencyMetrics(
+    filters?: AnalyticsFilters,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<TimeEfficiencyMetrics> {
+    return this.analyticsService.getTimeEfficiencyMetrics(filters, dateRange, options);
+  }
+
+  async getTimeEfficiencyMetricsByEntity(
+    groupBy: EntityType,
+    dateRange?: AnalyticsDateRange,
+    filters?: AnalyticsFilters,
+  ): Promise<GroupedTimeEfficiencyMetrics[]> {
+    return this.analyticsService.getTimeEfficiencyMetricsByEntity(groupBy, dateRange, filters);
+  }
+
+  async getCancellationMetrics(
+    groupBy: EntityType,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<CancellationMetrics | CancellationMetrics[]> {
+    return this.analyticsService.getCancellationMetrics(groupBy, dateRange, options);
+  }
+
+  async getNoShowMetrics(
+    groupBy: EntityType,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<NoShowMetrics | NoShowMetrics[]> {
+    return this.analyticsService.getNoShowMetrics(groupBy, dateRange, options);
+  }
+
+  async getRevenueMetrics(
+    filters?: AnalyticsFilters,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<RevenueMetrics> {
+    return this.analyticsService.getRevenueMetrics(filters, dateRange, options);
+  }
+
+  async getRevenueMetricsByEntity(
+    groupBy: EntityType,
+    dateRange?: AnalyticsDateRange,
+    filters?: AnalyticsFilters,
+  ): Promise<GroupedRevenueMetrics[]> {
+    return this.analyticsService.getRevenueMetricsByEntity(groupBy, dateRange, filters);
+  }
+
+  async getProductUsageMetrics(
+    productId?: string,
+    dateRange?: AnalyticsDateRange,
+  ): Promise<ProductUsageMetrics | ProductUsageMetrics[]> {
+    return this.analyticsService.getProductUsageMetrics(productId, dateRange);
+  }
+
+  async getProductUsageMetricsByEntity(
+    groupBy: EntityType,
+    dateRange?: AnalyticsDateRange,
+    filters?: AnalyticsFilters,
+  ): Promise<GroupedProductUsageMetrics[]> {
+    return this.analyticsService.getProductUsageMetricsByEntity(groupBy, dateRange, filters);
+  }
+
+  async getPatientAnalytics(
+    patientId?: string,
+    dateRange?: AnalyticsDateRange,
+  ): Promise<PatientAnalytics | PatientAnalytics[]> {
+    return this.analyticsService.getPatientAnalytics(patientId, dateRange);
+  }
+
+  async getPatientBehaviorMetricsByEntity(
+    groupBy: 'clinic' | 'practitioner' | 'procedure' | 'technology',
+    dateRange?: AnalyticsDateRange,
+    filters?: AnalyticsFilters,
+  ): Promise<GroupedPatientBehaviorMetrics[]> {
+    return this.analyticsService.getPatientBehaviorMetricsByEntity(groupBy, dateRange, filters);
+  }
+
+  async getClinicAnalytics(
+    clinicBranchId: string,
+    dateRange?: AnalyticsDateRange,
+  ): Promise<ClinicAnalytics | ClinicAnalytics[]> {
+    // Use getDashboardData to get clinic-level analytics
+    const dashboard = await this.analyticsService.getDashboardData(
+      { clinicBranchId },
+      dateRange,
+    );
+    
+    // Get clinic info
+    const clinicDoc = await this.db.collection('clinics').doc(clinicBranchId).get();
+    const clinicData = clinicDoc.data();
+    const clinicName = clinicData?.name || 'Unknown';
+    
+    // Convert DashboardAnalytics to ClinicAnalytics format
+    return {
+      clinicBranchId,
+      clinicName,
+      totalAppointments: dashboard.overview.totalAppointments,
+      completedAppointments: dashboard.overview.completedAppointments,
+      canceledAppointments: dashboard.overview.canceledAppointments,
+      noShowAppointments: dashboard.overview.noShowAppointments,
+      cancellationRate: dashboard.overview.cancellationRate,
+      noShowRate: dashboard.overview.noShowRate,
+      totalRevenue: dashboard.overview.totalRevenue,
+      averageRevenuePerAppointment: dashboard.overview.averageRevenuePerAppointment,
+      currency: dashboard.overview.currency,
+      practitionerCount: dashboard.overview.uniquePractitioners,
+      patientCount: dashboard.overview.uniquePatients,
+      procedureCount: dashboard.overview.uniqueProcedures,
+      topPractitioners: dashboard.practitionerMetrics.slice(0, 5).map(p => ({
+        practitionerId: p.practitionerId,
+        practitionerName: p.practitionerName,
+        appointmentCount: p.totalAppointments,
+        revenue: p.totalRevenue,
+      })),
+      topProcedures: dashboard.procedureMetrics.slice(0, 5).map(p => ({
+        procedureId: p.procedureId,
+        procedureName: p.procedureName,
+        appointmentCount: p.totalAppointments,
+        revenue: p.totalRevenue,
+      })),
+    };
+  }
+
+  async getDashboardData(
+    filters?: AnalyticsFilters,
+    dateRange?: AnalyticsDateRange,
+    options?: any,
+  ): Promise<DashboardAnalytics> {
+    return this.analyticsService.getDashboardData(filters, dateRange, options);
+  }
+
+  /**
+   * Expose fetchAppointments for direct access if needed
+   * This method is used internally by AnalyticsService
+   */
+  async fetchAppointments(
+    filters?: AnalyticsFilters,
+    dateRange?: AnalyticsDateRange,
+  ): Promise<any[]> {
+    // Access the private method via the service
+    return (this.analyticsService as any).fetchAppointments(filters, dateRange);
+  }
+}
+

package/src/admin/analytics/index.ts

@@ -1,2 +1,2 @@
-export * from './analytics.admin.service';
-
+export * from './analytics.admin.service';
+