@blackcode_sa/metaestetics-api 1.14.58 → 1.14.59

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

@@ -707,4 +707,61 @@ export class NotificationsAdmin {
       return null;
     }
   }
+
+  /**
+   * Sends a reminder push notification for a pending reschedule request.
+   * Used when a clinic has proposed a reschedule and the patient hasn't responded.
+   * @param appointment The appointment with pending reschedule.
+   * @param patientUserId The ID of the patient.
+   * @param patientExpoTokens Array of Expo push tokens for the patient.
+   * @param reminderCount Optional count of reminders already sent (for tracking).
+   */
+  async sendRescheduleReminderPush(
+    appointment: Appointment,
+    patientUserId: string,
+    patientExpoTokens: string[],
+    reminderCount?: number
+  ): Promise<string | null> {
+    if (!patientExpoTokens || patientExpoTokens.length === 0) {
+      console.log(
+        `[NotificationsAdmin] No expo tokens for patient ${patientUserId} for appointment ${appointment.id} reschedule reminder. Skipping push.`
+      );
+      return null;
+    }
+
+    const title = "Reminder: Reschedule Request Pending";
+    const body = `You have a pending reschedule request for your ${appointment.procedureInfo.name} appointment. Please respond in the app.`;
+
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
+
+    const notificationData: Omit<
+      Notification,
+      "id" | "createdAt" | "updatedAt" | "status" | "isRead"
+    > = {
+      userId: patientUserId,
+      userRole: UserRole.PATIENT,
+      notificationType: NotificationType.APPOINTMENT_RESCHEDULED_REMINDER,
+      notificationTime: notificationTimestampForDb as any,
+      notificationTokens: patientExpoTokens,
+      title,
+      body,
+      appointmentId: appointment.id,
+    };
+
+    try {
+      const notificationId = await this.createNotification(
+        notificationData as Notification
+      );
+      console.log(
+        `[NotificationsAdmin] Created APPOINTMENT_RESCHEDULED_REMINDER notification ${notificationId} for patient ${patientUserId}. Reminder count: ${reminderCount ?? 1}.`
+      );
+      return notificationId;
+    } catch (error) {
+      console.error(
+        `[NotificationsAdmin] Error creating APPOINTMENT_RESCHEDULED_REMINDER notification for patient ${patientUserId}:`,
+        error
+      );
+      return null;
+    }
+  }
 }

package/src/types/appointment/index.ts

@@ -319,6 +319,9 @@ export interface Appointment {
   confirmationTime?: Timestamp | null;
   cancellationTime?: Timestamp | null;
   rescheduleTime?: Timestamp | null;
+  /** Reschedule reminder tracking */
+  rescheduleReminderSentAt?: Timestamp | null;
+  rescheduleReminderCount?: number;
   appointmentStartTime: Timestamp;
   appointmentEndTime: Timestamp;
   procedureActualStartTime?: Timestamp | null; // NEW: Actual start time of the procedure
@@ -418,6 +421,9 @@ export interface UpdateAppointmentData {
   confirmationTime?: Timestamp | FieldValue | null;
   cancellationTime?: Timestamp | FieldValue | null;
   rescheduleTime?: Timestamp | FieldValue | null;
+  /** Reschedule reminder tracking */
+  rescheduleReminderSentAt?: Timestamp | FieldValue | null;
+  rescheduleReminderCount?: number | FieldValue;
   procedureActualStartTime?: Timestamp | FieldValue | null; // NEW
   actualDurationMinutes?: number;
   cancellationReason?: string | null;

package/src/types/notifications/index.ts

@@ -8,6 +8,7 @@ export enum NotificationType {
   APPOINTMENT_REMINDER = "appointmentReminder", // For upcoming appointments
   APPOINTMENT_STATUS_CHANGE = "appointmentStatusChange", // Generic for status changes like confirmed, checked-in etc.
   APPOINTMENT_RESCHEDULED_PROPOSAL = "appointmentRescheduledProposal", // When clinic proposes a new time
+  APPOINTMENT_RESCHEDULED_REMINDER = "appointmentRescheduledReminder", // Reminder for pending reschedule request
   APPOINTMENT_CANCELLED = "appointmentCancelled", // When an appointment is cancelled
 
   // --- Requirement-Driven Instructions ---
@@ -185,6 +186,18 @@ export interface AppointmentRescheduledProposalNotification
   // May include a deep link to confirm/reject reschedule.
 }
 
+/**
+ * Notification reminding the patient about a pending reschedule request they haven't responded to.
+ * Example: "Reminder: You have a pending reschedule request for your [Procedure Name] appointment."
+ */
+export interface AppointmentRescheduledReminderNotification
+  extends BaseNotification {
+  notificationType: NotificationType.APPOINTMENT_RESCHEDULED_REMINDER;
+  appointmentId: string; // Mandatory
+  procedureName?: string;
+  reminderCount?: number; // Number of reminders sent so far
+}
+
 /**
  * Notification informing about a cancelled appointment.
  * Example: "Your appointment for [Procedure Name] on [Date] has been cancelled."
@@ -277,6 +290,7 @@ export type Notification =
   | AppointmentReminderNotification
   | AppointmentStatusChangeNotification
   | AppointmentRescheduledProposalNotification
+  | AppointmentRescheduledReminderNotification
   | AppointmentCancelledNotification
   | FormReminderNotification
   | FormSubmissionConfirmationNotification