@blackcode_sa/metaestetics-api 1.6.5 → 1.6.6

package/src/admin/notifications/notifications.admin.ts

@@ -1,6 +1,13 @@
-import { Notification, NotificationStatus } from "../../types/notifications";
+import {
+  Notification,
+  NotificationStatus,
+  NotificationType,
+} from "../../types/notifications";
 import * as admin from "firebase-admin";
 import { Expo, ExpoPushMessage, ExpoPushTicket } from "expo-server-sdk";
+import { Appointment, PaymentStatus } from "../../types/appointment";
+import { UserRole } from "../../types";
+import { Timestamp as FirebaseClientTimestamp } from "@firebase/firestore";
 
 export class NotificationsAdmin {
   private expo: Expo;
@@ -222,4 +229,393 @@ export class NotificationsAdmin {
       );
     }
   }
+
+  // --- Business Specific Notification Methods (Revised) ---
+
+  /**
+   * 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).
+   */
+  async sendAppointmentConfirmedPush(
+    appointment: Appointment,
+    recipientUserId: string,
+    recipientExpoTokens: string[],
+    recipientRole: UserRole
+  ): Promise<string | null> {
+    if (recipientRole === UserRole.CLINIC_ADMIN) {
+      console.log(
+        `[NotificationsAdmin] Clinic admin roles do not receive push notifications for appointment ${appointment.id} confirmation. Skipping.`
+      );
+      return null;
+    }
+    if (!recipientExpoTokens || recipientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for ${recipientRole} ${recipientUserId} for appointment ${appointment.id} confirmation. Skipping push.`
+      );
+      return null;
+    }
+
+    let title = "Appointment Confirmed!";
+    let body = `Your appointment for ${
+      appointment.procedureInfo.name
+    } on ${appointment.appointmentStartTime
+      .toDate()
+      .toLocaleDateString()} at ${appointment.appointmentStartTime
+      .toDate()
+      .toLocaleTimeString()} has been confirmed.`;
+
+    if (recipientRole === UserRole.PRACTITIONER) {
+      title = "New Appointment Confirmed";
+      body = `Appointment for ${appointment.procedureInfo.name} with ${
+        appointment.patientInfo.fullName
+      } on ${appointment.appointmentStartTime
+        .toDate()
+        .toLocaleDateString()} is confirmed.`;
+    }
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: recipientUserId,
+      userRole: recipientRole,
+      notificationType: NotificationType.APPOINTMENT_STATUS_CHANGE,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: recipientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created APPOINTMENT_STATUS_CHANGE (Confirmed) notification ${notificationId} for ${recipientRole} ${recipientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating APPOINTMENT_STATUS_CHANGE (Confirmed) notification for ${recipientRole} ${recipientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
+  async sendAppointmentCancelledPush(
+    appointment: Appointment,
+    recipientUserId: string,
+    recipientExpoTokens: string[],
+    recipientRole: UserRole
+  ): Promise<string | null> {
+    if (recipientRole === UserRole.CLINIC_ADMIN) {
+      console.log(
+        `[NotificationsAdmin] Clinic admin roles do not receive push notifications for appointment ${appointment.id} cancellation. Skipping.`
+      );
+      return null;
+    }
+    if (!recipientExpoTokens || recipientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for ${recipientRole} ${recipientUserId} for appointment ${appointment.id} cancellation. Skipping push.`
+      );
+      return null;
+    }
+
+    let title = "Appointment Cancelled";
+    let body = `Your appointment for ${
+      appointment.procedureInfo.name
+    } on ${appointment.appointmentStartTime
+      .toDate()
+      .toLocaleDateString()} has been cancelled.`;
+    if (appointment.cancellationReason) {
+      body += ` Reason: ${appointment.cancellationReason}`;
+    }
+
+    if (recipientRole === UserRole.PRACTITIONER) {
+      body = `The appointment for ${appointment.procedureInfo.name} with ${
+        appointment.patientInfo.fullName
+      } on ${appointment.appointmentStartTime
+        .toDate()
+        .toLocaleDateString()} has been cancelled.`;
+      if (appointment.cancellationReason) {
+        body += ` Reason: ${appointment.cancellationReason}`;
+      }
+    }
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: recipientUserId,
+      userRole: recipientRole,
+      notificationType: NotificationType.APPOINTMENT_CANCELLED,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: recipientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created APPOINTMENT_CANCELLED notification ${notificationId} for ${recipientRole} ${recipientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating APPOINTMENT_CANCELLED notification for ${recipientRole} ${recipientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
+  async sendAppointmentRescheduledProposalPush(
+    appointment: Appointment,
+    patientUserId: string,
+    patientExpoTokens: string[]
+  ): Promise<string | null> {
+    if (!patientExpoTokens || patientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for patient ${patientUserId} for appointment ${appointment.id} reschedule proposal. Skipping push.`
+      );
+      return null;
+    }
+
+    const title = "Appointment Reschedule Proposed";
+    const body = `Action Required: A new time has been proposed for your appointment for ${appointment.procedureInfo.name}. Please review in the app.`;
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: patientUserId,
+      userRole: UserRole.PATIENT,
+      notificationType: NotificationType.APPOINTMENT_RESCHEDULED_PROPOSAL,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: patientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created APPOINTMENT_RESCHEDULED_PROPOSAL notification ${notificationId} for patient ${patientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating APPOINTMENT_RESCHEDULED_PROPOSAL notification for patient ${patientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
+  async sendPaymentUpdatePush(
+    appointment: Appointment,
+    patientUserId: string,
+    patientExpoTokens: string[]
+  ): Promise<string | null> {
+    if (!patientExpoTokens || patientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for patient ${patientUserId} for appointment ${appointment.id} payment update. Skipping push.`
+      );
+      return null;
+    }
+    const title = "Payment Updated";
+    const body = `Your payment status for the appointment (${
+      appointment.procedureInfo.name
+    }) on ${appointment.appointmentStartTime
+      .toDate()
+      .toLocaleDateString()} is now ${appointment.paymentStatus}.`;
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const notificationType =
+      appointment.paymentStatus === PaymentStatus.PAID
+        ? NotificationType.PAYMENT_CONFIRMATION
+        : NotificationType.GENERAL_MESSAGE;
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: patientUserId,
+      userRole: UserRole.PATIENT,
+      notificationType: notificationType,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: patientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created PAYMENT_UPDATE notification ${notificationId} for patient ${patientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating PAYMENT_UPDATE notification for patient ${patientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
+  async sendReviewRequestPush(
+    appointment: Appointment,
+    patientUserId: string,
+    patientExpoTokens: string[]
+  ): Promise<string | null> {
+    if (!patientExpoTokens || patientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for patient ${patientUserId} for appointment ${appointment.id} review request. Skipping push.`
+      );
+      return null;
+    }
+
+    const title = "Leave a Review";
+    const body = `How was your recent appointment for ${appointment.procedureInfo.name}? We'd love to hear your feedback!`;
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: patientUserId,
+      userRole: UserRole.PATIENT,
+      notificationType: NotificationType.REVIEW_REQUEST,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: patientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created REVIEW_REQUEST notification ${notificationId} for patient ${patientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating REVIEW_REQUEST notification for patient ${patientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
+  async sendReviewAddedPush(
+    appointment: Appointment,
+    recipientUserId: string,
+    recipientExpoTokens: string[],
+    recipientRole: UserRole
+  ): Promise<string | null> {
+    if (recipientRole !== UserRole.PRACTITIONER) {
+      console.log(
+        `[NotificationsAdmin] Only Practitioners receive review added push notifications (Role: ${recipientRole}). Skipping for appointment ${appointment.id}.`
+      );
+      return null;
+    }
+    if (!recipientExpoTokens || recipientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for practitioner ${recipientUserId} for appointment ${appointment.id} review added. Skipping push.`
+      );
+      return null;
+    }
+
+    const title = "New Review Received";
+    const body = `A new review has been added by ${
+      appointment.patientInfo.fullName
+    } for your appointment on ${appointment.appointmentStartTime
+      .toDate()
+      .toLocaleDateString()}.`;
+
+    const adminTsNow = admin.firestore.Timestamp.now();
+    const clientCompatibleNotificationTime = new FirebaseClientTimestamp(
+      adminTsNow.seconds,
+      adminTsNow.nanoseconds
+    );
+
+    const tempNotificationType = NotificationType.GENERAL_MESSAGE;
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: recipientUserId,
+      userRole: UserRole.PRACTITIONER,
+      notificationType: tempNotificationType,
+      notificationTime: clientCompatibleNotificationTime,
+      notificationTokens: recipientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created REVIEW_ADDED (using temp type ${tempNotificationType}) notification ${notificationId} for practitioner ${recipientUserId}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating REVIEW_ADDED (using temp type ${tempNotificationType}) notification for practitioner ${recipientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
 }

package/src/types/appointment/index.ts

@@ -93,6 +93,7 @@ export interface LinkedFormInfo {
   templateVersion: number;
   title: string; // For display, usually from DocumentTemplate.title
   isUserForm: boolean;
+  isRequired?: boolean;
   status: FilledDocumentStatus; // Status of the filled form (e.g., draft, completed, signed)
   path: string; // Full Firestore path to the filled document (e.g., appointments/{aid}/user-forms/{fid})
   submittedAt?: Timestamp;

package/src/types/notifications/index.ts

@@ -11,6 +11,8 @@ export enum NotificationType {
   APPOINTMENT_CANCELLED = "appointmentCancelled", // When an appointment is cancelled
 
   // --- Requirement-Driven Instructions ---
+  PRE_REQUIREMENT_INSTRUCTION_DUE = "preRequirementInstructionDue",
+  POST_REQUIREMENT_INSTRUCTION_DUE = "postRequirementInstructionDue",
   REQUIREMENT_INSTRUCTION_DUE = "requirementInstructionDue", // For specific pre/post care instructions
 
   // --- Form Related ---
@@ -106,7 +108,7 @@ export enum NotificationStatus {
  * Notifikacija za pre-requirement
  */
 export interface PreRequirementNotification extends BaseNotification {
-  notificationType: NotificationType.REQUIREMENT_INSTRUCTION_DUE;
+  notificationType: NotificationType.PRE_REQUIREMENT_INSTRUCTION_DUE;
   /** ID tretmana za koji je vezan pre-requirement */
   treatmentId: string;
   /** Lista pre-requirements koji treba da se ispune */
@@ -119,7 +121,7 @@ export interface PreRequirementNotification extends BaseNotification {
  * Notifikacija za post-requirement
  */
 export interface PostRequirementNotification extends BaseNotification {
-  notificationType: NotificationType.REQUIREMENT_INSTRUCTION_DUE;
+  notificationType: NotificationType.POST_REQUIREMENT_INSTRUCTION_DUE;
   /** ID tretmana za koji je vezan post-requirement */
   treatmentId: string;
   /** Lista post-requirements koji treba da se ispune */

package/src/validations/appointment.schema.ts

@@ -70,6 +70,7 @@ export const linkedFormInfoSchema = z.object({
     .positive("Template version must be a positive integer"),
   title: z.string().min(MIN_STRING_LENGTH, "Form title is required"),
   isUserForm: z.boolean(),
+  isRequired: z.boolean().optional(),
   status: filledDocumentStatusSchema,
   path: z.string().min(MIN_STRING_LENGTH, "Form path is required"),
   submittedAt: z