@blackcode_sa/metaestetics-api 1.6.5 → 1.6.6

package/dist/admin/index.d.ts

@@ -1143,6 +1143,8 @@ declare enum NotificationType {
     APPOINTMENT_STATUS_CHANGE = "appointmentStatusChange",// Generic for status changes like confirmed, checked-in etc.
     APPOINTMENT_RESCHEDULED_PROPOSAL = "appointmentRescheduledProposal",// When clinic proposes a new time
     APPOINTMENT_CANCELLED = "appointmentCancelled",// When an appointment is cancelled
+    PRE_REQUIREMENT_INSTRUCTION_DUE = "preRequirementInstructionDue",
+    POST_REQUIREMENT_INSTRUCTION_DUE = "postRequirementInstructionDue",
     REQUIREMENT_INSTRUCTION_DUE = "requirementInstructionDue",// For specific pre/post care instructions
     FORM_REMINDER = "formReminder",// Reminds user to fill a specific form
     FORM_SUBMISSION_CONFIRMATION = "formSubmissionConfirmation",// Confirms form was submitted
@@ -1209,7 +1211,7 @@ declare enum NotificationStatus {
  * Notifikacija za pre-requirement
  */
 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 */
@@ -1221,7 +1223,7 @@ interface PreRequirementNotification extends BaseNotification {
  * Notifikacija za post-requirement
  */
 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 */
@@ -1333,6 +1335,177 @@ interface PaymentConfirmationNotification extends BaseNotification {
  */
 type Notification = PreRequirementNotification | PostRequirementNotification | RequirementInstructionDueNotification | AppointmentReminderNotification | AppointmentStatusChangeNotification | AppointmentRescheduledProposalNotification | AppointmentCancelledNotification | FormReminderNotification | FormSubmissionConfirmationNotification | ReviewRequestNotification | GeneralMessageNotification | PaymentConfirmationNotification;
 
+/**
+ * Enum defining the possible statuses of an appointment.
+ */
+declare enum AppointmentStatus {
+    PENDING = "pending",// Initial state after booking, before confirmation (if applicable)
+    CONFIRMED = "confirmed",// Confirmed by clinic/practitioner
+    CHECKED_IN = "checked_in",// Patient has arrived
+    IN_PROGRESS = "in_progress",// Procedure has started
+    COMPLETED = "completed",// Procedure finished successfully
+    CANCELED_PATIENT = "canceled_patient",// Canceled by the patient
+    CANCELED_PATIENT_RESCHEDULED = "canceled_patient_rescheduled",// Canceled by the patient and rescheduled by the clinic
+    CANCELED_CLINIC = "canceled_clinic",// Canceled by the clinic/practitioner
+    NO_SHOW = "no_show",// Patient did not attend
+    RESCHEDULED_BY_CLINIC = "rescheduled_by_clinic"
+}
+/**
+ * Enum defining the payment status of an appointment.
+ */
+declare enum PaymentStatus {
+    UNPAID = "unpaid",
+    PAID = "paid",
+    PARTIALLY_PAID = "partially_paid",
+    REFUNDED = "refunded",
+    NOT_APPLICABLE = "not_applicable"
+}
+/**
+ * Enum for different types of media that can be attached to an appointment.
+ */
+declare enum MediaType {
+    BEFORE_PHOTO = "before_photo",
+    AFTER_PHOTO = "after_photo",
+    CONSENT_SCAN = "consent_scan",
+    OTHER_DOCUMENT = "other_document"
+}
+/**
+ * Interface to describe a media file linked to an appointment.
+ */
+interface AppointmentMediaItem {
+    id: string;
+    type: MediaType;
+    url: string;
+    fileName?: string;
+    uploadedAt: Timestamp;
+    uploadedBy: string;
+    description?: string;
+}
+/**
+ * Interface for procedure-specific information
+ */
+interface ProcedureExtendedInfo {
+    id: string;
+    name: string;
+    description: string;
+    cost: number;
+    duration: number;
+    procedureFamily: ProcedureFamily;
+    procedureCategoryId: string;
+    procedureCategoryName: string;
+    procedureSubCategoryId: string;
+    procedureSubCategoryName: string;
+    procedureTechnologyId: string;
+    procedureTechnologyName: string;
+    procedureProductBrandId: string;
+    procedureProductBrandName: string;
+    procedureProductId: string;
+    procedureProductName: string;
+}
+/**
+ * Interface to describe a filled form linked to an appointment.
+ */
+interface LinkedFormInfo {
+    formId: string;
+    templateId: string;
+    templateVersion: number;
+    title: string;
+    isUserForm: boolean;
+    isRequired?: boolean;
+    status: FilledDocumentStatus;
+    path: string;
+    submittedAt?: Timestamp;
+    completedAt?: Timestamp;
+}
+/**
+ * Interface for summarized patient review information linked to an appointment.
+ */
+interface PatientReviewInfo {
+    reviewId: string;
+    rating: number;
+    comment?: string;
+    reviewedAt: Timestamp;
+}
+/**
+ * Represents a booked appointment, aggregating key information and relevant procedure rules.
+ */
+interface Appointment {
+    /** Unique identifier for the appointment */
+    id: string;
+    /** Reference to the associated CalendarEvent */
+    calendarEventId: string;
+    /** ID of the clinic branch */
+    clinicBranchId: string;
+    /** Aggregated clinic information (snapshot) */
+    clinicInfo: ClinicInfo;
+    /** ID of the practitioner */
+    practitionerId: string;
+    /** Aggregated practitioner information (snapshot) */
+    practitionerInfo: PractitionerProfileInfo;
+    /** ID of the patient */
+    patientId: string;
+    /** Aggregated patient information (snapshot) */
+    patientInfo: PatientProfileInfo;
+    /** ID of the procedure */
+    procedureId: string;
+    /** Aggregated procedure information including product/brand (snapshot) */
+    procedureInfo: ProcedureSummaryInfo;
+    /** Extended procedure information */
+    procedureExtendedInfo: ProcedureExtendedInfo;
+    /** Status of the appointment */
+    status: AppointmentStatus;
+    /** Timestamps */
+    bookingTime: Timestamp;
+    confirmationTime?: Timestamp | null;
+    cancellationTime?: Timestamp | null;
+    rescheduleTime?: Timestamp | null;
+    appointmentStartTime: Timestamp;
+    appointmentEndTime: Timestamp;
+    procedureActualStartTime?: Timestamp | null;
+    actualDurationMinutes?: number;
+    /** Cancellation Details */
+    cancellationReason?: string | null;
+    canceledBy?: "patient" | "clinic" | "practitioner" | "system";
+    /** Notes */
+    internalNotes?: string | null;
+    patientNotes?: string | null;
+    /** Payment Details */
+    cost: number;
+    currency: Currency;
+    paymentStatus: PaymentStatus;
+    paymentTransactionId?: string | null;
+    /** Procedure-related conditions and requirements */
+    blockingConditions: BlockingCondition[];
+    contraindications: Contraindication[];
+    preProcedureRequirements: Requirement[];
+    postProcedureRequirements: Requirement[];
+    /** Tracking information for requirements completion */
+    completedPreRequirements?: string[];
+    completedPostRequirements?: string[];
+    /** NEW: Linked forms (consent, procedure-specific forms, etc.) */
+    linkedFormIds?: string[];
+    linkedForms?: LinkedFormInfo[];
+    pendingUserFormsIds?: string[];
+    /** NEW: Media items (before/after photos, scanned documents, etc.) */
+    media?: AppointmentMediaItem[];
+    /** NEW: Information about the patient's review for this appointment */
+    reviewInfo?: PatientReviewInfo | null;
+    /** NEW: Details about the finalization of the appointment by the practitioner */
+    finalizedDetails?: {
+        by: string;
+        at: Timestamp;
+        notes?: string;
+    };
+    /** Timestamps for record creation and updates */
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    /** Recurring appointment information */
+    isRecurring?: boolean;
+    recurringAppointmentId?: string | null;
+    /** NEW: Flag for soft deletion or archiving */
+    isArchived?: boolean;
+}
+
 declare class NotificationsAdmin {
     private expo;
     private db;
@@ -1365,6 +1538,19 @@ declare class NotificationsAdmin {
      * Briše stare notifikacije sa batch procesiranjem
      */
     cleanupOldNotifications(daysOld?: number, batchSize?: number): Promise<void>;
+    /**
+     * 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).
+     */
+    sendAppointmentConfirmedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+    sendAppointmentCancelledPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
+    sendAppointmentRescheduledProposalPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendPaymentUpdatePush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendReviewRequestPush(appointment: Appointment, patientUserId: string, patientExpoTokens: string[]): Promise<string | null>;
+    sendReviewAddedPush(appointment: Appointment, recipientUserId: string, recipientExpoTokens: string[], recipientRole: UserRole): Promise<string | null>;
 }
 
 /**
@@ -1739,176 +1925,6 @@ declare class PractitionerInviteMailingService extends BaseMailingService {
     }): Promise<void>;
 }
 
-/**
- * Enum defining the possible statuses of an appointment.
- */
-declare enum AppointmentStatus {
-    PENDING = "pending",// Initial state after booking, before confirmation (if applicable)
-    CONFIRMED = "confirmed",// Confirmed by clinic/practitioner
-    CHECKED_IN = "checked_in",// Patient has arrived
-    IN_PROGRESS = "in_progress",// Procedure has started
-    COMPLETED = "completed",// Procedure finished successfully
-    CANCELED_PATIENT = "canceled_patient",// Canceled by the patient
-    CANCELED_PATIENT_RESCHEDULED = "canceled_patient_rescheduled",// Canceled by the patient and rescheduled by the clinic
-    CANCELED_CLINIC = "canceled_clinic",// Canceled by the clinic/practitioner
-    NO_SHOW = "no_show",// Patient did not attend
-    RESCHEDULED_BY_CLINIC = "rescheduled_by_clinic"
-}
-/**
- * Enum defining the payment status of an appointment.
- */
-declare enum PaymentStatus {
-    UNPAID = "unpaid",
-    PAID = "paid",
-    PARTIALLY_PAID = "partially_paid",
-    REFUNDED = "refunded",
-    NOT_APPLICABLE = "not_applicable"
-}
-/**
- * Enum for different types of media that can be attached to an appointment.
- */
-declare enum MediaType {
-    BEFORE_PHOTO = "before_photo",
-    AFTER_PHOTO = "after_photo",
-    CONSENT_SCAN = "consent_scan",
-    OTHER_DOCUMENT = "other_document"
-}
-/**
- * Interface to describe a media file linked to an appointment.
- */
-interface AppointmentMediaItem {
-    id: string;
-    type: MediaType;
-    url: string;
-    fileName?: string;
-    uploadedAt: Timestamp;
-    uploadedBy: string;
-    description?: string;
-}
-/**
- * Interface for procedure-specific information
- */
-interface ProcedureExtendedInfo {
-    id: string;
-    name: string;
-    description: string;
-    cost: number;
-    duration: number;
-    procedureFamily: ProcedureFamily;
-    procedureCategoryId: string;
-    procedureCategoryName: string;
-    procedureSubCategoryId: string;
-    procedureSubCategoryName: string;
-    procedureTechnologyId: string;
-    procedureTechnologyName: string;
-    procedureProductBrandId: string;
-    procedureProductBrandName: string;
-    procedureProductId: string;
-    procedureProductName: string;
-}
-/**
- * Interface to describe a filled form linked to an appointment.
- */
-interface LinkedFormInfo {
-    formId: string;
-    templateId: string;
-    templateVersion: number;
-    title: string;
-    isUserForm: boolean;
-    status: FilledDocumentStatus;
-    path: string;
-    submittedAt?: Timestamp;
-    completedAt?: Timestamp;
-}
-/**
- * Interface for summarized patient review information linked to an appointment.
- */
-interface PatientReviewInfo {
-    reviewId: string;
-    rating: number;
-    comment?: string;
-    reviewedAt: Timestamp;
-}
-/**
- * Represents a booked appointment, aggregating key information and relevant procedure rules.
- */
-interface Appointment {
-    /** Unique identifier for the appointment */
-    id: string;
-    /** Reference to the associated CalendarEvent */
-    calendarEventId: string;
-    /** ID of the clinic branch */
-    clinicBranchId: string;
-    /** Aggregated clinic information (snapshot) */
-    clinicInfo: ClinicInfo;
-    /** ID of the practitioner */
-    practitionerId: string;
-    /** Aggregated practitioner information (snapshot) */
-    practitionerInfo: PractitionerProfileInfo;
-    /** ID of the patient */
-    patientId: string;
-    /** Aggregated patient information (snapshot) */
-    patientInfo: PatientProfileInfo;
-    /** ID of the procedure */
-    procedureId: string;
-    /** Aggregated procedure information including product/brand (snapshot) */
-    procedureInfo: ProcedureSummaryInfo;
-    /** Extended procedure information */
-    procedureExtendedInfo: ProcedureExtendedInfo;
-    /** Status of the appointment */
-    status: AppointmentStatus;
-    /** Timestamps */
-    bookingTime: Timestamp;
-    confirmationTime?: Timestamp | null;
-    cancellationTime?: Timestamp | null;
-    rescheduleTime?: Timestamp | null;
-    appointmentStartTime: Timestamp;
-    appointmentEndTime: Timestamp;
-    procedureActualStartTime?: Timestamp | null;
-    actualDurationMinutes?: number;
-    /** Cancellation Details */
-    cancellationReason?: string | null;
-    canceledBy?: "patient" | "clinic" | "practitioner" | "system";
-    /** Notes */
-    internalNotes?: string | null;
-    patientNotes?: string | null;
-    /** Payment Details */
-    cost: number;
-    currency: Currency;
-    paymentStatus: PaymentStatus;
-    paymentTransactionId?: string | null;
-    /** Procedure-related conditions and requirements */
-    blockingConditions: BlockingCondition[];
-    contraindications: Contraindication[];
-    preProcedureRequirements: Requirement[];
-    postProcedureRequirements: Requirement[];
-    /** Tracking information for requirements completion */
-    completedPreRequirements?: string[];
-    completedPostRequirements?: string[];
-    /** NEW: Linked forms (consent, procedure-specific forms, etc.) */
-    linkedFormIds?: string[];
-    linkedForms?: LinkedFormInfo[];
-    pendingUserFormsIds?: string[];
-    /** NEW: Media items (before/after photos, scanned documents, etc.) */
-    media?: AppointmentMediaItem[];
-    /** NEW: Information about the patient's review for this appointment */
-    reviewInfo?: PatientReviewInfo | null;
-    /** NEW: Details about the finalization of the appointment by the practitioner */
-    finalizedDetails?: {
-        by: string;
-        at: Timestamp;
-        notes?: string;
-    };
-    /** Timestamps for record creation and updates */
-    createdAt: Timestamp;
-    updatedAt: Timestamp;
-    /** Recurring appointment information */
-    isRecurring?: boolean;
-    recurringAppointmentId?: string | null;
-    /** NEW: Flag for soft deletion or archiving */
-    isArchived?: boolean;
-}
-
 /**
  * Interface for the data required by orchestrateAppointmentCreation
  */
@@ -1925,6 +1941,7 @@ interface OrchestrateAppointmentCreationData {
  */
 declare class BookingAdmin {
     private db;
+    private documentManagerAdmin;
     /**
      * Creates a new BookingAdmin instance
      * @param firestore - Firestore instance provided by the caller
@@ -1973,6 +1990,7 @@ declare class BookingAdmin {
      * @returns Promise resolving to an array of calendar events
      */
     private getPractitionerCalendarEvents;
+    private _generateCalendarProcedureInfo;
     /**
      * Orchestrates the creation of a new appointment, including data aggregation.
      * This method is intended to be called from a trusted backend environment (e.g., an Express route handler in a Cloud Function).
@@ -1985,8 +2003,13 @@ declare class BookingAdmin {
         success: boolean;
         appointmentId?: string;
         appointmentData?: Appointment;
+        practitionerCalendarEventId?: string;
+        patientCalendarEventId?: string;
+        clinicCalendarEventId?: string;
         error?: string;
     }>;
+    private _generateProcedureSummaryInfo;
+    private _generateProcedureExtendedInfo;
 }
 
 /**