@blackcode_sa/metaestetics-api 1.13.3 → 1.13.5

package/src/services/calendar/utils/index.ts

@@ -1,8 +1,8 @@
-// Export core calendar utilities
-export * from "./calendar-event.utils";
-export * from "./synced-calendar.utils";
-export * from "./google-calendar.utils";
-export * from "./appointment.utils";
-
-// Note: Other utility files (clinic.utils.ts, patient.utils.ts, practitioner.utils.ts, docs.utils.ts)
-// should be imported directly where needed to avoid naming conflicts
+// Export core calendar utilities
+export * from "./calendar-event.utils";
+export * from "./synced-calendar.utils";
+export * from "./google-calendar.utils";
+export * from "./appointment.utils";
+
+// Note: Other utility files (clinic.utils.ts, patient.utils.ts, practitioner.utils.ts, docs.utils.ts)
+// should be imported directly where needed to avoid naming conflicts

package/src/services/calendar/utils/patient.utils.ts

@@ -1,198 +1,198 @@
-import {
-  Firestore,
-  collection,
-  doc,
-  getDoc,
-  getDocs,
-  setDoc,
-  updateDoc,
-  deleteDoc,
-  query,
-  where,
-  orderBy,
-  Timestamp,
-  serverTimestamp,
-  QueryConstraint,
-} from "firebase/firestore";
-import {
-  CalendarEvent,
-  CalendarEventStatus,
-  CalendarEventType,
-  CreateCalendarEventData,
-  UpdateCalendarEventData,
-  CALENDAR_COLLECTION,
-} from "../../../types/calendar";
-import { getPatientCalendarEventDocRef } from "./docs.utils";
-
-/**
- * Creates a calendar event for a patient
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @param eventData - Calendar event data
- * @param generateId - Function to generate a unique ID
- * @returns Created calendar event
- */
-export async function createPatientCalendarEventUtil(
-  db: Firestore,
-  patientId: string,
-  eventData: Omit<CreateCalendarEventData, "id" | "createdAt" | "updatedAt">,
-  generateId: () => string
-): Promise<CalendarEvent> {
-  // TODO: Add validation for event data
-  // - Check if patient exists
-  // - Validate event time (start < end)
-  // - Check for overlapping events
-  // - Validate required fields
-
-  const eventId = generateId();
-  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
-
-  const newEvent: CreateCalendarEventData = {
-    id: eventId,
-    ...eventData,
-    createdAt: serverTimestamp(),
-    updatedAt: serverTimestamp(),
-  };
-
-  await setDoc(eventRef, newEvent);
-
-  // Convert server timestamp to Timestamp for return value
-  return {
-    ...newEvent,
-    createdAt: Timestamp.now(),
-    updatedAt: Timestamp.now(),
-  } as CalendarEvent;
-}
-
-/**
- * Gets a calendar event for a patient
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @param eventId - ID of the event
- * @returns Calendar event or null if not found
- */
-export async function getPatientCalendarEventUtil(
-  db: Firestore,
-  patientId: string,
-  eventId: string
-): Promise<CalendarEvent | null> {
-  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
-  const eventDoc = await getDoc(eventRef);
-
-  if (!eventDoc.exists()) {
-    return null;
-  }
-
-  return eventDoc.data() as CalendarEvent;
-}
-
-/**
- * Gets calendar events for a patient within a date range
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @param startDate - Start date of the range
- * @param endDate - End date of the range
- * @param additionalConstraints - Additional query constraints
- * @returns Array of calendar events
- */
-export async function getPatientCalendarEventsUtil(
-  db: Firestore,
-  patientId: string,
-  startDate: Date,
-  endDate: Date,
-  additionalConstraints: QueryConstraint[] = []
-): Promise<CalendarEvent[]> {
-  const startTimestamp = Timestamp.fromDate(startDate);
-  const endTimestamp = Timestamp.fromDate(endDate);
-
-  const eventsRef = collection(
-    db,
-    `${CALENDAR_COLLECTION}`,
-    patientId,
-    `${CALENDAR_COLLECTION}`
-  );
-
-  const constraints: QueryConstraint[] = [
-    where("eventTime.start", ">=", startTimestamp),
-    where("eventTime.end", "<=", endTimestamp),
-    orderBy("eventTime.start", "asc"),
-    ...additionalConstraints,
-  ];
-
-  const q = query(eventsRef, ...constraints);
-
-  const querySnapshot = await getDocs(q);
-  return querySnapshot.docs.map((doc) => doc.data() as CalendarEvent);
-}
-
-/**
- * Gets upcoming appointments for a patient
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @returns Array of upcoming calendar events
- */
-export async function getUpcomingPatientAppointmentsUtil(
-  db: Firestore,
-  patientId: string
-): Promise<CalendarEvent[]> {
-  const now = new Date();
-  const oneYearFromNow = new Date();
-  oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1);
-
-  return getPatientCalendarEventsUtil(db, patientId, now, oneYearFromNow, [
-    where("eventType", "==", CalendarEventType.APPOINTMENT),
-  ]);
-}
-
-/**
- * Updates a calendar event for a patient
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @param eventId - ID of the event
- * @param updateData - Data to update
- * @returns Updated calendar event
- */
-export async function updatePatientCalendarEventUtil(
-  db: Firestore,
-  patientId: string,
-  eventId: string,
-  updateData: Omit<UpdateCalendarEventData, "updatedAt">
-): Promise<CalendarEvent> {
-  // TODO: Add validation for update data
-  // - Check if event exists
-  // - Validate event time (start < end)
-  // - Check for overlapping events
-
-  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
-
-  const updates: UpdateCalendarEventData = {
-    ...updateData,
-    updatedAt: serverTimestamp(),
-  };
-
-  await updateDoc(eventRef, updates as any);
-
-  // Get the updated document
-  const updatedDoc = await getDoc(eventRef);
-
-  if (!updatedDoc.exists()) {
-    throw new Error("Event not found after update");
-  }
-
-  return updatedDoc.data() as CalendarEvent;
-}
-
-/**
- * Deletes a calendar event for a patient
- * @param db - Firestore instance
- * @param patientId - ID of the patient
- * @param eventId - ID of the event
- */
-export async function deletePatientCalendarEventUtil(
-  db: Firestore,
-  patientId: string,
-  eventId: string
-): Promise<void> {
-  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
-  await deleteDoc(eventRef);
-}
+import {
+  Firestore,
+  collection,
+  doc,
+  getDoc,
+  getDocs,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  query,
+  where,
+  orderBy,
+  Timestamp,
+  serverTimestamp,
+  QueryConstraint,
+} from "firebase/firestore";
+import {
+  CalendarEvent,
+  CalendarEventStatus,
+  CalendarEventType,
+  CreateCalendarEventData,
+  UpdateCalendarEventData,
+  CALENDAR_COLLECTION,
+} from "../../../types/calendar";
+import { getPatientCalendarEventDocRef } from "./docs.utils";
+
+/**
+ * Creates a calendar event for a patient
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @param eventData - Calendar event data
+ * @param generateId - Function to generate a unique ID
+ * @returns Created calendar event
+ */
+export async function createPatientCalendarEventUtil(
+  db: Firestore,
+  patientId: string,
+  eventData: Omit<CreateCalendarEventData, "id" | "createdAt" | "updatedAt">,
+  generateId: () => string
+): Promise<CalendarEvent> {
+  // TODO: Add validation for event data
+  // - Check if patient exists
+  // - Validate event time (start < end)
+  // - Check for overlapping events
+  // - Validate required fields
+
+  const eventId = generateId();
+  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
+
+  const newEvent: CreateCalendarEventData = {
+    id: eventId,
+    ...eventData,
+    createdAt: serverTimestamp(),
+    updatedAt: serverTimestamp(),
+  };
+
+  await setDoc(eventRef, newEvent);
+
+  // Convert server timestamp to Timestamp for return value
+  return {
+    ...newEvent,
+    createdAt: Timestamp.now(),
+    updatedAt: Timestamp.now(),
+  } as CalendarEvent;
+}
+
+/**
+ * Gets a calendar event for a patient
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @returns Calendar event or null if not found
+ */
+export async function getPatientCalendarEventUtil(
+  db: Firestore,
+  patientId: string,
+  eventId: string
+): Promise<CalendarEvent | null> {
+  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
+  const eventDoc = await getDoc(eventRef);
+
+  if (!eventDoc.exists()) {
+    return null;
+  }
+
+  return eventDoc.data() as CalendarEvent;
+}
+
+/**
+ * Gets calendar events for a patient within a date range
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @param startDate - Start date of the range
+ * @param endDate - End date of the range
+ * @param additionalConstraints - Additional query constraints
+ * @returns Array of calendar events
+ */
+export async function getPatientCalendarEventsUtil(
+  db: Firestore,
+  patientId: string,
+  startDate: Date,
+  endDate: Date,
+  additionalConstraints: QueryConstraint[] = []
+): Promise<CalendarEvent[]> {
+  const startTimestamp = Timestamp.fromDate(startDate);
+  const endTimestamp = Timestamp.fromDate(endDate);
+
+  const eventsRef = collection(
+    db,
+    `${CALENDAR_COLLECTION}`,
+    patientId,
+    `${CALENDAR_COLLECTION}`
+  );
+
+  const constraints: QueryConstraint[] = [
+    where("eventTime.start", ">=", startTimestamp),
+    where("eventTime.end", "<=", endTimestamp),
+    orderBy("eventTime.start", "asc"),
+    ...additionalConstraints,
+  ];
+
+  const q = query(eventsRef, ...constraints);
+
+  const querySnapshot = await getDocs(q);
+  return querySnapshot.docs.map((doc) => doc.data() as CalendarEvent);
+}
+
+/**
+ * Gets upcoming appointments for a patient
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @returns Array of upcoming calendar events
+ */
+export async function getUpcomingPatientAppointmentsUtil(
+  db: Firestore,
+  patientId: string
+): Promise<CalendarEvent[]> {
+  const now = new Date();
+  const oneYearFromNow = new Date();
+  oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1);
+
+  return getPatientCalendarEventsUtil(db, patientId, now, oneYearFromNow, [
+    where("eventType", "==", CalendarEventType.APPOINTMENT),
+  ]);
+}
+
+/**
+ * Updates a calendar event for a patient
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ * @param updateData - Data to update
+ * @returns Updated calendar event
+ */
+export async function updatePatientCalendarEventUtil(
+  db: Firestore,
+  patientId: string,
+  eventId: string,
+  updateData: Omit<UpdateCalendarEventData, "updatedAt">
+): Promise<CalendarEvent> {
+  // TODO: Add validation for update data
+  // - Check if event exists
+  // - Validate event time (start < end)
+  // - Check for overlapping events
+
+  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
+
+  const updates: UpdateCalendarEventData = {
+    ...updateData,
+    updatedAt: serverTimestamp(),
+  };
+
+  await updateDoc(eventRef, updates as any);
+
+  // Get the updated document
+  const updatedDoc = await getDoc(eventRef);
+
+  if (!updatedDoc.exists()) {
+    throw new Error("Event not found after update");
+  }
+
+  return updatedDoc.data() as CalendarEvent;
+}
+
+/**
+ * Deletes a calendar event for a patient
+ * @param db - Firestore instance
+ * @param patientId - ID of the patient
+ * @param eventId - ID of the event
+ */
+export async function deletePatientCalendarEventUtil(
+  db: Firestore,
+  patientId: string,
+  eventId: string
+): Promise<void> {
+  const eventRef = getPatientCalendarEventDocRef(db, patientId, eventId);
+  await deleteDoc(eventRef);
+}