@blackcode_sa/metaestetics-api 1.6.14 → 1.6.16

package/dist/admin/index.js

@@ -30,11 +30,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/admin/index.ts
 var index_exports = {};
 __export(index_exports, {
+  APPOINTMENTS_COLLECTION: () => APPOINTMENTS_COLLECTION,
   AppointmentAggregationService: () => AppointmentAggregationService,
+  AppointmentMailingService: () => AppointmentMailingService,
   AppointmentStatus: () => AppointmentStatus,
   BaseMailingService: () => BaseMailingService,
   BookingAdmin: () => BookingAdmin,
+  BookingAvailabilityCalculator: () => BookingAvailabilityCalculator,
+  CalendarAdminService: () => CalendarAdminService,
   ClinicAggregationService: () => ClinicAggregationService,
+  DocumentManagerAdminService: () => DocumentManagerAdminService,
+  Logger: () => Logger,
+  MediaType: () => MediaType,
   NOTIFICATIONS_COLLECTION: () => NOTIFICATIONS_COLLECTION,
   NotificationStatus: () => NotificationStatus,
   NotificationType: () => NotificationType,
@@ -44,6 +51,7 @@ __export(index_exports, {
   PatientInstructionStatus: () => PatientInstructionStatus,
   PatientRequirementOverallStatus: () => PatientRequirementOverallStatus,
   PatientRequirementsAdminService: () => PatientRequirementsAdminService,
+  PaymentStatus: () => PaymentStatus,
   PractitionerAggregationService: () => PractitionerAggregationService,
   PractitionerInviteMailingService: () => PractitionerInviteMailingService,
   PractitionerTokenStatus: () => PractitionerTokenStatus,
@@ -84,7 +92,7 @@ var NotificationStatus = /* @__PURE__ */ ((NotificationStatus2) => {
 })(NotificationStatus || {});
 
 // src/admin/notifications/notifications.admin.ts
-var admin2 = __toESM(require("firebase-admin"));
+var admin = __toESM(require("firebase-admin"));
 var import_expo_server_sdk = require("expo-server-sdk");
 
 // src/types/appointment/index.ts
@@ -101,6 +109,21 @@ var AppointmentStatus = /* @__PURE__ */ ((AppointmentStatus2) => {
   AppointmentStatus2["RESCHEDULED_BY_CLINIC"] = "rescheduled_by_clinic";
   return AppointmentStatus2;
 })(AppointmentStatus || {});
+var PaymentStatus = /* @__PURE__ */ ((PaymentStatus2) => {
+  PaymentStatus2["UNPAID"] = "unpaid";
+  PaymentStatus2["PAID"] = "paid";
+  PaymentStatus2["PARTIALLY_PAID"] = "partially_paid";
+  PaymentStatus2["REFUNDED"] = "refunded";
+  PaymentStatus2["NOT_APPLICABLE"] = "not_applicable";
+  return PaymentStatus2;
+})(PaymentStatus || {});
+var MediaType = /* @__PURE__ */ ((MediaType2) => {
+  MediaType2["BEFORE_PHOTO"] = "before_photo";
+  MediaType2["AFTER_PHOTO"] = "after_photo";
+  MediaType2["CONSENT_SCAN"] = "consent_scan";
+  MediaType2["OTHER_DOCUMENT"] = "other_document";
+  return MediaType2;
+})(MediaType || {});
 var APPOINTMENTS_COLLECTION = "appointments";
 
 // src/types/documentation-templates/index.ts
@@ -119,109 +142,61 @@ var UserRole = /* @__PURE__ */ ((UserRole2) => {
   return UserRole2;
 })(UserRole || {});
 
-// src/utils/TimestampUtils.ts
-var admin = __toESM(require("firebase-admin"));
-var import_firestore = require("firebase/firestore");
-var TimestampUtils = class {
-  /**
-   * Converts an admin Firestore Timestamp to a client Firestore Timestamp
-   * @param adminTimestamp - Admin SDK Timestamp (from firebase-admin)
-   * @returns A client SDK Timestamp (from firebase/firestore) with same seconds/nanoseconds or null if input is null
-   */
-  static adminToClient(adminTimestamp) {
-    if (!adminTimestamp) return null;
-    return new import_firestore.Timestamp(
-      adminTimestamp.seconds,
-      adminTimestamp.nanoseconds
-    );
-  }
-  /**
-   * Converts a client Firestore Timestamp to an admin Firestore Timestamp
-   * @param clientTimestamp - Client SDK Timestamp (from firebase/firestore)
-   * @returns An admin SDK Timestamp (from firebase-admin) with same seconds/nanoseconds or null if input is null
-   */
-  static clientToAdmin(clientTimestamp) {
-    if (!clientTimestamp) return null;
-    return new admin.firestore.Timestamp(
-      clientTimestamp.seconds,
-      clientTimestamp.nanoseconds
-    );
-  }
-  /**
-   * Creates a client-compatible timestamp for the current time
-   * @returns A client SDK Timestamp (from firebase/firestore) for the current time
-   */
-  static nowAsClient() {
-    const now = admin.firestore.Timestamp.now();
-    return this.adminToClient(now);
-  }
+// src/admin/logger/index.ts
+var firebaseFunctionsLogger;
+try {
+  firebaseFunctionsLogger = require("firebase-functions/logger");
+  require("firebase-functions/logger/compat");
+} catch (e) {
+}
+var Logger = class {
   /**
-   * Converts a Date object to a client Firestore Timestamp
-   * @param date - JavaScript Date object
-   * @returns A client SDK Timestamp (from firebase/firestore) or null if input is null
+   * Log an error message
+   * @param message Message to log
+   * @param data Optional data to include
    */
-  static dateToClientTimestamp(date) {
-    if (!date) return null;
-    return import_firestore.Timestamp.fromDate(date);
+  static error(message, data) {
+    if (firebaseFunctionsLogger) {
+      firebaseFunctionsLogger.error(message, data);
+    } else {
+      console.error(message, data !== void 0 ? data : "");
+    }
   }
   /**
-   * Converts a Date object to an admin Firestore Timestamp
-   * @param date - JavaScript Date object
-   * @returns An admin SDK Timestamp (from firebase-admin) or null if input is null
+   * Log a warning message
+   * @param message Message to log
+   * @param data Optional data to include
    */
-  static dateToAdminTimestamp(date) {
-    if (!date) return null;
-    return admin.firestore.Timestamp.fromDate(date);
+  static warn(message, data) {
+    if (firebaseFunctionsLogger) {
+      firebaseFunctionsLogger.warn(message, data);
+    } else {
+      console.warn(message, data !== void 0 ? data : "");
+    }
   }
   /**
-   * Deeply converts all admin Firestore Timestamps in an object to client Firestore Timestamps
-   * @param obj - Object that may contain admin Firestore Timestamps
-   * @returns The same object with all admin Timestamps converted to client Timestamps
+   * Log an info message
+   * @param message Message to log
+   * @param data Optional data to include
    */
-  static convertObjectTimestampsAdminToClient(obj) {
-    if (!obj || typeof obj !== "object") {
-      return obj;
-    }
-    if (obj instanceof admin.firestore.Timestamp) {
-      return this.adminToClient(obj);
-    }
-    if (Array.isArray(obj)) {
-      return obj.map(
-        (item) => this.convertObjectTimestampsAdminToClient(item)
-      );
-    }
-    const result = { ...obj };
-    for (const key in result) {
-      if (Object.prototype.hasOwnProperty.call(result, key)) {
-        result[key] = this.convertObjectTimestampsAdminToClient(result[key]);
-      }
+  static info(message, data) {
+    if (firebaseFunctionsLogger) {
+      firebaseFunctionsLogger.info(message, data);
+    } else {
+      console.info(message, data !== void 0 ? data : "");
     }
-    return result;
   }
   /**
-   * Deeply converts all client Firestore Timestamps in an object to admin Firestore Timestamps
-   * @param obj - Object that may contain client Firestore Timestamps
-   * @returns The same object with all client Timestamps converted to admin Timestamps
+   * Log a debug message
+   * @param message Message to log
+   * @param data Optional data to include
    */
-  static convertObjectTimestampsClientToAdmin(obj) {
-    if (!obj || typeof obj !== "object") {
-      return obj;
-    }
-    if (obj instanceof import_firestore.Timestamp) {
-      return this.clientToAdmin(obj);
-    }
-    if (Array.isArray(obj)) {
-      return obj.map(
-        (item) => this.convertObjectTimestampsClientToAdmin(item)
-      );
-    }
-    const result = { ...obj };
-    for (const key in result) {
-      if (Object.prototype.hasOwnProperty.call(result, key)) {
-        result[key] = this.convertObjectTimestampsClientToAdmin(result[key]);
-      }
+  static debug(message, data) {
+    if (firebaseFunctionsLogger) {
+      firebaseFunctionsLogger.debug(message, data);
+    } else {
+      console.debug(message, data !== void 0 ? data : "");
     }
-    return result;
   }
 };
 
@@ -229,7 +204,7 @@ var TimestampUtils = class {
 var NotificationsAdmin = class {
   constructor(firestore12) {
     this.expo = new import_expo_server_sdk.Expo();
-    this.db = firestore12 || admin2.firestore();
+    this.db = firestore12 || admin.firestore();
   }
   /**
    * Dohvata notifikaciju po ID-u
@@ -245,8 +220,8 @@ var NotificationsAdmin = class {
     const docRef = await this.db.collection("notifications").add({
       ...notification,
       status: "pending" /* PENDING */,
-      createdAt: admin2.firestore.FieldValue.serverTimestamp(),
-      updatedAt: admin2.firestore.FieldValue.serverTimestamp()
+      createdAt: admin.firestore.FieldValue.serverTimestamp(),
+      updatedAt: admin.firestore.FieldValue.serverTimestamp()
     });
     return docRef.id;
   }
@@ -254,7 +229,18 @@ var NotificationsAdmin = class {
    * Priprema Expo poruku za slanje
    */
   prepareExpoMessage(notification) {
-    return notification.notificationTokens.filter((token) => import_expo_server_sdk.Expo.isExpoPushToken(token)).map((token) => ({
+    const validTokens = notification.notificationTokens.filter(
+      (token) => import_expo_server_sdk.Expo.isExpoPushToken(token)
+    );
+    Logger.info(
+      `[NotificationsAdmin] Preparing Expo messages for notification ${notification.id}`,
+      {
+        totalTokens: notification.notificationTokens.length,
+        validTokens: validTokens.length,
+        invalidTokensCount: notification.notificationTokens.length - validTokens.length
+      }
+    );
+    return validTokens.map((token) => ({
       to: token,
       sound: "default",
       title: notification.title,
@@ -272,10 +258,10 @@ var NotificationsAdmin = class {
   async updateNotificationStatus(notificationId, status, error) {
     const update = {
       status,
-      updatedAt: admin2.firestore.FieldValue.serverTimestamp()
+      updatedAt: admin.firestore.FieldValue.serverTimestamp()
     };
     if (status === "sent" /* SENT */) {
-      update.sentAt = admin2.firestore.FieldValue.serverTimestamp();
+      update.sentAt = admin.firestore.FieldValue.serverTimestamp();
     }
     if (error) {
       update.error = error;
@@ -286,45 +272,94 @@ var NotificationsAdmin = class {
    * Šalje notifikaciju kroz Expo servis sa boljim error handlingom
    */
   async sendPushNotification(notification) {
+    var _a;
     try {
+      Logger.info(
+        `[NotificationsAdmin] Processing notification ${notification.id} for sending`,
+        {
+          userId: notification.userId,
+          tokenCount: ((_a = notification.notificationTokens) == null ? void 0 : _a.length) || 0,
+          type: notification.notificationType
+        }
+      );
       const messages = this.prepareExpoMessage(notification);
       if (messages.length === 0) {
+        const errorMsg = "No valid notification tokens found";
+        Logger.error(
+          `[NotificationsAdmin] ${errorMsg} for notification ${notification.id}`
+        );
         await this.updateNotificationStatus(
           notification.id,
           "failed" /* FAILED */,
-          "No valid notification tokens found"
+          errorMsg
         );
         return false;
       }
       const chunks = this.expo.chunkPushNotifications(messages);
+      Logger.info(
+        `[NotificationsAdmin] Sending ${messages.length} messages in ${chunks.length} chunks for notification ${notification.id}`
+      );
       const tickets = [];
-      for (const chunk of chunks) {
+      for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
         try {
+          Logger.info(
+            `[NotificationsAdmin] Sending chunk ${i + 1}/${chunks.length} with ${chunk.length} messages`
+          );
           const ticketChunk = await this.expo.sendPushNotificationsAsync(chunk);
+          Logger.info(
+            `[NotificationsAdmin] Received ${ticketChunk.length} tickets for chunk ${i + 1}`
+          );
           tickets.push(ticketChunk);
         } catch (error) {
-          console.error(`Chunk sending error:`, error);
+          Logger.error(
+            `[NotificationsAdmin] Chunk ${i + 1} sending error:`,
+            error
+          );
           throw error;
         }
       }
       let hasErrors = false;
       const errors = [];
-      tickets.flat().forEach((ticket, index) => {
+      const ticketsFlat = tickets.flat();
+      const ticketResults = {
+        total: ticketsFlat.length,
+        success: 0,
+        error: 0,
+        errorDetails: {}
+      };
+      ticketsFlat.forEach((ticket, index) => {
         if (ticket.status === "error") {
           hasErrors = true;
-          errors.push(
-            `Token ${notification.notificationTokens[index]}: ${ticket.message}`
-          );
+          ticketResults.error++;
+          const errorMessage = ticket.message || "Unknown error";
+          ticketResults.errorDetails[errorMessage] = (ticketResults.errorDetails[errorMessage] || 0) + 1;
+          const tokenInfo = index < notification.notificationTokens.length ? `Token ${notification.notificationTokens[index]}` : `Token at index ${index}`;
+          errors.push(`${tokenInfo}: ${errorMessage}`);
+        } else {
+          ticketResults.success++;
         }
       });
+      Logger.info(
+        `[NotificationsAdmin] Ticket results for notification ${notification.id}`,
+        ticketResults
+      );
       if (hasErrors) {
+        const errorSummary = errors.join("; ");
+        Logger.warn(
+          `[NotificationsAdmin] Partial success or errors in notification ${notification.id}`,
+          { errorCount: errors.length, errorSummary }
+        );
         await this.updateNotificationStatus(
           notification.id,
-          "partialSuccess" /* PARTIAL_SUCCESS */,
-          errors.join("; ")
+          ticketResults.success > 0 ? "partialSuccess" /* PARTIAL_SUCCESS */ : "failed" /* FAILED */,
+          errorSummary
         );
-        return false;
+        return ticketResults.success > 0;
       }
+      Logger.info(
+        `[NotificationsAdmin] Successfully sent notification ${notification.id} to all recipients`
+      );
       await this.updateNotificationStatus(
         notification.id,
         "sent" /* SENT */
@@ -332,7 +367,10 @@ var NotificationsAdmin = class {
       return true;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "Unknown error";
-      console.error("Gre\u0161ka pri slanju notifikacije:", error);
+      Logger.error(
+        `[NotificationsAdmin] Critical error sending notification ${notification.id}:`,
+        error
+      );
       await this.updateNotificationStatus(
         notification.id,
         "failed" /* FAILED */,
@@ -345,14 +383,29 @@ var NotificationsAdmin = class {
    * Procesira notifikacije koje čekaju na slanje sa batch limitom
    */
   async processPendingNotifications(batchSize = 100) {
-    const now = admin2.firestore.Timestamp.now();
+    const now = admin.firestore.Timestamp.now();
+    Logger.info(
+      `[NotificationsAdmin] Starting to process pending notifications with batch size ${batchSize}`
+    );
     const pendingNotifications = await this.db.collection("notifications").where("status", "==", "pending" /* PENDING */).where("notificationTime", "<=", now).limit(batchSize).get();
+    Logger.info(
+      `[NotificationsAdmin] Found ${pendingNotifications.size} pending notifications to process`
+    );
+    if (pendingNotifications.empty) {
+      Logger.info(
+        "[NotificationsAdmin] No pending notifications found to process"
+      );
+      return;
+    }
     const results = await Promise.allSettled(
       pendingNotifications.docs.map(async (doc) => {
         const notification = {
           id: doc.id,
           ...doc.data()
         };
+        Logger.info(
+          `[NotificationsAdmin] Processing notification ${notification.id} of type ${notification.notificationType}`
+        );
         return this.sendPushNotification(notification);
       })
     );
@@ -362,8 +415,8 @@ var NotificationsAdmin = class {
     const failed = results.filter(
       (r) => r.status === "rejected" || r.status === "fulfilled" && !r.value
     ).length;
-    console.log(
-      `Processed ${results.length} notifications: ${successful} successful, ${failed} failed`
+    Logger.info(
+      `[NotificationsAdmin] Processed ${results.length} notifications: ${successful} successful, ${failed} failed`
     );
   }
   /**
@@ -372,13 +425,20 @@ var NotificationsAdmin = class {
   async cleanupOldNotifications(daysOld = 30, batchSize = 500) {
     const cutoffDate = /* @__PURE__ */ new Date();
     cutoffDate.setDate(cutoffDate.getDate() - daysOld);
+    Logger.info(
+      `[NotificationsAdmin] Starting cleanup of notifications older than ${daysOld} days`
+    );
+    let totalDeleted = 0;
     while (true) {
       const oldNotifications = await this.db.collection("notifications").where(
         "createdAt",
         "<=",
-        admin2.firestore.Timestamp.fromDate(cutoffDate)
+        admin.firestore.Timestamp.fromDate(cutoffDate)
       ).limit(batchSize).get();
       if (oldNotifications.empty) {
+        Logger.info(
+          `[NotificationsAdmin] No more old notifications to delete. Total deleted: ${totalDeleted}`
+        );
         break;
       }
       const batch = this.db.batch();
@@ -386,8 +446,9 @@ var NotificationsAdmin = class {
         batch.delete(doc.ref);
       });
       await batch.commit();
-      console.log(
-        `Deleted batch of ${oldNotifications.size} old notifications`
+      totalDeleted += oldNotifications.size;
+      Logger.info(
+        `[NotificationsAdmin] Deleted batch of ${oldNotifications.size} old notifications. Running total: ${totalDeleted}`
       );
     }
   }
@@ -418,15 +479,12 @@ var NotificationsAdmin = class {
       title = "New Appointment Confirmed";
       body = `Appointment for ${appointment.procedureInfo.name} with ${appointment.patientInfo.fullName} on ${appointment.appointmentStartTime.toDate().toLocaleDateString()} is confirmed.`;
     }
-    const adminTsNow = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const notificationData = {
       userId: recipientUserId,
       userRole: recipientRole,
       notificationType: "appointmentStatusChange" /* APPOINTMENT_STATUS_CHANGE */,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: recipientExpoTokens,
       title,
       body,
@@ -472,15 +530,12 @@ var NotificationsAdmin = class {
         body += ` Reason: ${appointment.cancellationReason}`;
       }
     }
-    const adminTsNow = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const notificationData = {
       userId: recipientUserId,
       userRole: recipientRole,
       notificationType: "appointmentCancelled" /* APPOINTMENT_CANCELLED */,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: recipientExpoTokens,
       title,
       body,
@@ -511,15 +566,12 @@ var NotificationsAdmin = class {
     }
     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 = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const notificationData = {
       userId: patientUserId,
       userRole: "patient" /* PATIENT */,
       notificationType: "appointmentRescheduledProposal" /* APPOINTMENT_RESCHEDULED_PROPOSAL */,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: patientExpoTokens,
       title,
       body,
@@ -550,16 +602,13 @@ var NotificationsAdmin = class {
     }
     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 = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const notificationType = appointment.paymentStatus === "paid" /* PAID */ ? "paymentConfirmation" /* PAYMENT_CONFIRMATION */ : "generalMessage" /* GENERAL_MESSAGE */;
     const notificationData = {
       userId: patientUserId,
       userRole: "patient" /* PATIENT */,
       notificationType,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: patientExpoTokens,
       title,
       body,
@@ -590,15 +639,12 @@ var NotificationsAdmin = class {
     }
     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 = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const notificationData = {
       userId: patientUserId,
       userRole: "patient" /* PATIENT */,
       notificationType: "reviewRequest" /* REVIEW_REQUEST */,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: patientExpoTokens,
       title,
       body,
@@ -635,16 +681,13 @@ var NotificationsAdmin = class {
     }
     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 = admin2.firestore.Timestamp.now();
-    const clientCompatibleNotificationTime = TimestampUtils.adminToClient(
-      adminTsNow
-    );
+    const notificationTimestampForDb = admin.firestore.Timestamp.now();
     const tempNotificationType = "generalMessage" /* GENERAL_MESSAGE */;
     const notificationData = {
       userId: recipientUserId,
       userRole: "practitioner" /* PRACTITIONER */,
       notificationType: tempNotificationType,
-      notificationTime: clientCompatibleNotificationTime,
+      notificationTime: notificationTimestampForDb,
       notificationTokens: recipientExpoTokens,
       title,
       body,
@@ -668,6 +711,187 @@ var NotificationsAdmin = class {
   }
 };
 
+// src/utils/TimestampUtils.ts
+var admin2 = __toESM(require("firebase-admin"));
+var import_firestore = require("firebase/firestore");
+var IS_SERVER_ENV = process.env.NODE_ENV === "production" || process.env.FUNCTIONS_EMULATOR === "true" || process.env.FIREBASE_CONFIG !== void 0;
+var TimestampUtils = class {
+  /**
+   * Enables server mode where admin timestamps are preserved when saving
+   * to Firestore via the admin SDK
+   */
+  static enableServerMode() {
+    this.serverMode = true;
+  }
+  /**
+   * Disables server mode - use this only for client-side or mixed environments
+   */
+  static disableServerMode() {
+    this.serverMode = false;
+  }
+  /**
+   * Converts an admin Firestore Timestamp to a client Firestore Timestamp
+   * In server mode, returns the original admin timestamp for storage consistency
+   *
+   * @param adminTimestamp - Admin SDK Timestamp (from firebase-admin)
+   * @returns A client SDK Timestamp (from firebase/firestore) with same seconds/nanoseconds,
+   *          or the original admin timestamp in server mode,
+   *          or null if input is null
+   */
+  static adminToClient(adminTimestamp) {
+    if (!adminTimestamp) return null;
+    if (this.serverMode) {
+      return adminTimestamp;
+    }
+    return new import_firestore.Timestamp(
+      adminTimestamp.seconds,
+      adminTimestamp.nanoseconds
+    );
+  }
+  /**
+   * Converts a client Firestore Timestamp to an admin Firestore Timestamp
+   * @param clientTimestamp - Client SDK Timestamp (from firebase/firestore)
+   * @returns An admin SDK Timestamp (from firebase-admin) with same seconds/nanoseconds or null if input is null
+   */
+  static clientToAdmin(clientTimestamp) {
+    if (!clientTimestamp) return null;
+    return new admin2.firestore.Timestamp(
+      clientTimestamp.seconds,
+      clientTimestamp.nanoseconds
+    );
+  }
+  /**
+   * Creates a timestamp for the current time in the appropriate format based on environment
+   * @returns A timestamp for the current time (admin timestamp in server mode, client in client mode)
+   */
+  static nowAsTimestamp() {
+    const now = admin2.firestore.Timestamp.now();
+    if (this.serverMode) {
+      return now;
+    }
+    return this.adminToClient(now);
+  }
+  /**
+   * @deprecated Use nowAsTimestamp() instead for better cross-environment compatibility
+   */
+  static nowAsClient() {
+    const now = admin2.firestore.Timestamp.now();
+    return this.adminToClient(now);
+  }
+  /**
+   * Converts a Date object to a timestamp in the appropriate format based on environment
+   * @param date - JavaScript Date object
+   * @returns A timestamp (admin timestamp in server mode, client in client mode) or null if input is null
+   */
+  static dateToTimestamp(date) {
+    if (!date) return null;
+    if (this.serverMode) {
+      return admin2.firestore.Timestamp.fromDate(date);
+    }
+    return import_firestore.Timestamp.fromDate(date);
+  }
+  /**
+   * @deprecated Use dateToTimestamp() instead for better cross-environment compatibility
+   */
+  static dateToClientTimestamp(date) {
+    if (!date) return null;
+    return import_firestore.Timestamp.fromDate(date);
+  }
+  /**
+   * @deprecated Use dateToTimestamp() instead for better cross-environment compatibility
+   */
+  static dateToAdminTimestamp(date) {
+    if (!date) return null;
+    return admin2.firestore.Timestamp.fromDate(date);
+  }
+  /**
+   * Gets a server timestamp field value for use in create/update operations
+   * Works in both admin and client environments
+   */
+  static serverTimestamp() {
+    if (this.serverMode) {
+      return admin2.firestore.FieldValue.serverTimestamp();
+    }
+    throw new Error("Server timestamp in client mode not implemented");
+  }
+  /**
+   * For objects with mixed timestamp types, ensures all timestamps are
+   * in the correct format for the current environment
+   */
+  static normalizeTimestamps(obj) {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+    if (obj instanceof admin2.firestore.Timestamp) {
+      return this.serverMode ? obj : this.adminToClient(obj);
+    }
+    if (obj instanceof import_firestore.Timestamp && this.serverMode) {
+      return this.clientToAdmin(obj);
+    }
+    if (Array.isArray(obj)) {
+      return obj.map((item) => this.normalizeTimestamps(item));
+    }
+    const result = { ...obj };
+    for (const key in result) {
+      if (Object.prototype.hasOwnProperty.call(result, key)) {
+        result[key] = this.normalizeTimestamps(result[key]);
+      }
+    }
+    return result;
+  }
+  /**
+   * @deprecated Use normalizeTimestamps() instead for better cross-environment compatibility
+   */
+  static convertObjectTimestampsAdminToClient(obj) {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+    if (obj instanceof admin2.firestore.Timestamp) {
+      return this.adminToClient(obj);
+    }
+    if (Array.isArray(obj)) {
+      return obj.map(
+        (item) => this.convertObjectTimestampsAdminToClient(item)
+      );
+    }
+    const result = { ...obj };
+    for (const key in result) {
+      if (Object.prototype.hasOwnProperty.call(result, key)) {
+        result[key] = this.convertObjectTimestampsAdminToClient(result[key]);
+      }
+    }
+    return result;
+  }
+  /**
+   * @deprecated Use normalizeTimestamps() instead for better cross-environment compatibility
+   */
+  static convertObjectTimestampsClientToAdmin(obj) {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+    if (obj instanceof import_firestore.Timestamp) {
+      return this.clientToAdmin(obj);
+    }
+    if (Array.isArray(obj)) {
+      return obj.map(
+        (item) => this.convertObjectTimestampsClientToAdmin(item)
+      );
+    }
+    const result = { ...obj };
+    for (const key in result) {
+      if (Object.prototype.hasOwnProperty.call(result, key)) {
+        result[key] = this.convertObjectTimestampsClientToAdmin(result[key]);
+      }
+    }
+    return result;
+  }
+};
+/**
+ * Flag to force server mode where admin timestamps are preserved
+ * This should be true in Cloud Functions environments
+ */
+TimestampUtils.serverMode = IS_SERVER_ENV;
+
 // src/admin/aggregation/clinic/clinic.aggregation.service.ts
 var admin3 = __toESM(require("firebase-admin"));
 
@@ -2128,7 +2352,7 @@ var PatientRequirementsAdminService = class {
           userRole: "patient" /* PATIENT */,
           notificationType: "requirementInstructionDue" /* REQUIREMENT_INSTRUCTION_DUE */,
           notificationTime: currentInstruction.dueTime,
-          // This is a Firestore Timestamp
+          // dueTime should be an admin.firestore.Timestamp already
           notificationTokens: patientExpoTokens,
           title: `Reminder: ${instance.requirementName}`,
           body: currentInstruction.instructionText,
@@ -2356,66 +2580,6 @@ var PatientRequirementsAdminService = class {
 
 // src/admin/calendar/calendar.admin.service.ts
 var admin8 = __toESM(require("firebase-admin"));
-
-// src/admin/logger/index.ts
-var firebaseFunctionsLogger;
-try {
-  firebaseFunctionsLogger = require("firebase-functions/logger");
-  require("firebase-functions/logger/compat");
-} catch (e) {
-}
-var Logger = class {
-  /**
-   * Log an error message
-   * @param message Message to log
-   * @param data Optional data to include
-   */
-  static error(message, data) {
-    if (firebaseFunctionsLogger) {
-      firebaseFunctionsLogger.error(message, data);
-    } else {
-      console.error(message, data !== void 0 ? data : "");
-    }
-  }
-  /**
-   * Log a warning message
-   * @param message Message to log
-   * @param data Optional data to include
-   */
-  static warn(message, data) {
-    if (firebaseFunctionsLogger) {
-      firebaseFunctionsLogger.warn(message, data);
-    } else {
-      console.warn(message, data !== void 0 ? data : "");
-    }
-  }
-  /**
-   * Log an info message
-   * @param message Message to log
-   * @param data Optional data to include
-   */
-  static info(message, data) {
-    if (firebaseFunctionsLogger) {
-      firebaseFunctionsLogger.info(message, data);
-    } else {
-      console.info(message, data !== void 0 ? data : "");
-    }
-  }
-  /**
-   * Log a debug message
-   * @param message Message to log
-   * @param data Optional data to include
-   */
-  static debug(message, data) {
-    if (firebaseFunctionsLogger) {
-      firebaseFunctionsLogger.debug(message, data);
-    } else {
-      console.debug(message, data !== void 0 ? data : "");
-    }
-  }
-};
-
-// src/admin/calendar/calendar.admin.service.ts
 var CalendarAdminService = class {
   constructor(firestore12) {
     this.db = firestore12 || admin8.firestore();
@@ -2470,14 +2634,8 @@ var CalendarAdminService = class {
     const batch = this.db.batch();
     const serverTimestamp = admin8.firestore.FieldValue.serverTimestamp();
     const firestoreCompatibleEventTime = {
-      start: {
-        seconds: newEventTime.start.seconds,
-        nanoseconds: newEventTime.start.nanoseconds
-      },
-      end: {
-        seconds: newEventTime.end.seconds,
-        nanoseconds: newEventTime.end.nanoseconds
-      }
+      start: TimestampUtils.clientToAdmin(newEventTime.start) || admin8.firestore.Timestamp.now(),
+      end: TimestampUtils.clientToAdmin(newEventTime.end) || admin8.firestore.Timestamp.now()
     };
     if (appointment.calendarEventId) {
       const practitionerEventRef = this.db.doc(
@@ -3225,7 +3383,8 @@ var AppointmentAggregationService = class {
             status: "pendingNotification" /* PENDING_NOTIFICATION */,
             originalNotifyAtValue: notifyAtValue,
             originalTimeframeUnit: template.timeframe.unit,
-            updatedAt: admin10.firestore.FieldValue.serverTimestamp(),
+            updatedAt: admin10.firestore.Timestamp.now(),
+            // Use current server timestamp
             notificationId: void 0,
             actionTakenAt: void 0
           };
@@ -3335,7 +3494,8 @@ var AppointmentAggregationService = class {
             status: "pendingNotification" /* PENDING_NOTIFICATION */,
             originalNotifyAtValue: notifyAtValue,
             originalTimeframeUnit: template.timeframe.unit,
-            updatedAt: admin10.firestore.FieldValue.serverTimestamp(),
+            updatedAt: admin10.firestore.Timestamp.now(),
+            // Use current server timestamp
             notificationId: void 0,
             actionTakenAt: void 0
           };
@@ -4546,8 +4706,12 @@ var BookingAdmin = class {
     return events.map((event) => ({
       ...event,
       eventTime: {
-        start: TimestampUtils.adminToClient(event.eventTime.start),
-        end: TimestampUtils.adminToClient(event.eventTime.end)
+        start: TimestampUtils.adminToClient(
+          event.eventTime.start
+        ),
+        end: TimestampUtils.adminToClient(
+          event.eventTime.end
+        )
       }
       // Convert any other timestamps in the event if needed
     }));
@@ -5012,13 +5176,21 @@ var BookingAdmin = class {
 
 // src/admin/index.ts
 console.log("[Admin Module] Initialized and services exported.");
+TimestampUtils.enableServerMode();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  APPOINTMENTS_COLLECTION,
   AppointmentAggregationService,
+  AppointmentMailingService,
   AppointmentStatus,
   BaseMailingService,
   BookingAdmin,
+  BookingAvailabilityCalculator,
+  CalendarAdminService,
   ClinicAggregationService,
+  DocumentManagerAdminService,
+  Logger,
+  MediaType,
   NOTIFICATIONS_COLLECTION,
   NotificationStatus,
   NotificationType,
@@ -5028,6 +5200,7 @@ console.log("[Admin Module] Initialized and services exported.");
   PatientInstructionStatus,
   PatientRequirementOverallStatus,
   PatientRequirementsAdminService,
+  PaymentStatus,
   PractitionerAggregationService,
   PractitionerInviteMailingService,
   PractitionerTokenStatus,