@blackcode_sa/metaestetics-api 1.12.72 → 1.13.1

package/src/services/analytics/utils/trend-calculation.utils.ts

@@ -0,0 +1,200 @@
+import { Appointment } from '../../../types/appointment';
+import { Timestamp } from 'firebase/firestore';
+
+/**
+ * Trend period type
+ */
+export type TrendPeriod = 'week' | 'month' | 'quarter' | 'year';
+
+/**
+ * Period information for trend grouping
+ */
+export interface PeriodInfo {
+  period: string; // e.g., "2024-W01", "2024-01", "2024-Q1", "2024"
+  startDate: Date;
+  endDate: Date;
+}
+
+/**
+ * Calculates the start and end dates for a given period
+ */
+export function getPeriodDates(date: Date, period: TrendPeriod): PeriodInfo {
+  const year = date.getFullYear();
+  const month = date.getMonth();
+  const day = date.getDate();
+
+  let startDate: Date;
+  let endDate: Date;
+  let periodString: string;
+
+  switch (period) {
+    case 'week': {
+      // Get Monday of the week
+      const dayOfWeek = date.getDay();
+      const diff = date.getDate() - dayOfWeek + (dayOfWeek === 0 ? -6 : 1); // Adjust when day is Sunday
+      startDate = new Date(year, month, diff);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(startDate);
+      endDate.setDate(endDate.getDate() + 6);
+      endDate.setHours(23, 59, 59, 999);
+
+      // ISO week format: YYYY-Www
+      const weekNumber = getWeekNumber(date);
+      periodString = `${year}-W${weekNumber.toString().padStart(2, '0')}`;
+      break;
+    }
+
+    case 'month': {
+      startDate = new Date(year, month, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, month + 1, 0);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}-${(month + 1).toString().padStart(2, '0')}`;
+      break;
+    }
+
+    case 'quarter': {
+      const quarter = Math.floor(month / 3);
+      const quarterStartMonth = quarter * 3;
+      
+      startDate = new Date(year, quarterStartMonth, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, quarterStartMonth + 3, 0);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}-Q${quarter + 1}`;
+      break;
+    }
+
+    case 'year': {
+      startDate = new Date(year, 0, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, 11, 31);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}`;
+      break;
+    }
+  }
+
+  return {
+    period: periodString,
+    startDate,
+    endDate,
+  };
+}
+
+/**
+ * Gets ISO week number for a date
+ */
+function getWeekNumber(date: Date): number {
+  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+  const dayNum = d.getUTCDay() || 7;
+  d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+}
+
+/**
+ * Groups appointments by trend period
+ */
+export function groupAppointmentsByPeriod(
+  appointments: Appointment[],
+  period: TrendPeriod,
+): Map<string, Appointment[]> {
+  const periodMap = new Map<string, Appointment[]>();
+
+  appointments.forEach(appointment => {
+    const appointmentDate = appointment.appointmentStartTime.toDate();
+    const periodInfo = getPeriodDates(appointmentDate, period);
+    const periodKey = periodInfo.period;
+
+    if (!periodMap.has(periodKey)) {
+      periodMap.set(periodKey, []);
+    }
+    periodMap.get(periodKey)!.push(appointment);
+  });
+
+  return periodMap;
+}
+
+/**
+ * Generates all periods between start and end date for a given period type
+ */
+export function generatePeriods(
+  startDate: Date,
+  endDate: Date,
+  period: TrendPeriod,
+): PeriodInfo[] {
+  const periods: PeriodInfo[] = [];
+  const current = new Date(startDate);
+
+  while (current <= endDate) {
+    const periodInfo = getPeriodDates(current, period);
+    
+    // Only add if period overlaps with our date range
+    if (periodInfo.endDate >= startDate && periodInfo.startDate <= endDate) {
+      periods.push(periodInfo);
+    }
+
+    // Move to next period
+    switch (period) {
+      case 'week':
+        current.setDate(current.getDate() + 7);
+        break;
+      case 'month':
+        current.setMonth(current.getMonth() + 1);
+        break;
+      case 'quarter':
+        current.setMonth(current.getMonth() + 3);
+        break;
+      case 'year':
+        current.setFullYear(current.getFullYear() + 1);
+        break;
+    }
+  }
+
+  return periods.sort((a, b) => a.startDate.getTime() - b.startDate.getTime());
+}
+
+/**
+ * Calculates percentage change between two values
+ * @param current - Current value
+ * @param previous - Previous value
+ * @returns Percentage change (positive = increase, negative = decrease)
+ */
+export function calculatePercentageChange(current: number, previous: number): number {
+  if (previous === 0) {
+    return current > 0 ? 100 : 0;
+  }
+  return ((current - previous) / previous) * 100;
+}
+
+/**
+ * Gets trend direction and percentage change
+ */
+export interface TrendChange {
+  value: number;
+  previousValue: number;
+  percentageChange: number;
+  direction: 'up' | 'down' | 'stable';
+}
+
+export function getTrendChange(current: number, previous: number): TrendChange {
+  const percentageChange = calculatePercentageChange(current, previous);
+  const direction: 'up' | 'down' | 'stable' =
+    percentageChange > 0.01 ? 'up' : percentageChange < -0.01 ? 'down' : 'stable';
+
+  return {
+    value: current,
+    previousValue: previous,
+    percentageChange: Math.abs(percentageChange),
+    direction,
+  };
+}
+

package/src/services/index.ts

@@ -1,3 +1,4 @@
+export * from "./analytics";
 export * from "./appointment";
 export * from "./auth";
 export * from "./calendar";