@blackcode_sa/metaestetics-api 1.12.69 → 1.12.71

package/dist/index.d.mts

@@ -7634,6 +7634,18 @@ declare class PatientRequirementsService extends BaseService {
 
 declare class ReviewService extends BaseService {
     constructor(db: Firestore, auth: Auth, app: FirebaseApp);
+    /**
+     * Helper function to convert Firestore Timestamps to Date objects
+     * @param timestamp The timestamp to convert
+     * @returns A JavaScript Date object or null
+     */
+    private convertTimestamp;
+    /**
+     * Converts a Firestore document to a Review object with proper date handling
+     * @param docData The raw Firestore document data
+     * @returns A Review object with properly converted dates
+     */
+    private convertDocToReview;
     /**
      * Creates a new review
      * @param data - The review data to create

package/dist/index.d.ts

@@ -7634,6 +7634,18 @@ declare class PatientRequirementsService extends BaseService {
 
 declare class ReviewService extends BaseService {
     constructor(db: Firestore, auth: Auth, app: FirebaseApp);
+    /**
+     * Helper function to convert Firestore Timestamps to Date objects
+     * @param timestamp The timestamp to convert
+     * @returns A JavaScript Date object or null
+     */
+    private convertTimestamp;
+    /**
+     * Converts a Firestore document to a Review object with proper date handling
+     * @param docData The raw Firestore document data
+     * @returns A Review object with properly converted dates
+     */
+    private convertDocToReview;
     /**
      * Creates a new review
      * @param data - The review data to create

package/dist/index.js

@@ -18088,6 +18088,77 @@ var ReviewService = class extends BaseService {
   constructor(db, auth, app) {
     super(db, auth, app);
   }
+  /**
+   * Helper function to convert Firestore Timestamps to Date objects
+   * @param timestamp The timestamp to convert
+   * @returns A JavaScript Date object or null
+   */
+  convertTimestamp(timestamp) {
+    if (!timestamp) {
+      console.warn("\u26A0\uFE0F convertTimestamp received null/undefined timestamp");
+      return /* @__PURE__ */ new Date();
+    }
+    console.log("\u{1F50D} convertTimestamp input:", {
+      type: typeof timestamp,
+      value: timestamp,
+      hasToDate: (timestamp == null ? void 0 : timestamp.toDate) !== void 0,
+      hasIsTimestamp: (timestamp == null ? void 0 : timestamp.__isTimestamp) !== void 0,
+      hasSeconds: (timestamp == null ? void 0 : timestamp.seconds) !== void 0
+    });
+    if (timestamp && timestamp.__isTimestamp === true && typeof timestamp.seconds === "number") {
+      const converted = new Date(timestamp.seconds * 1e3 + (timestamp.nanoseconds || 0) / 1e6);
+      console.log("\u2705 Converted __isTimestamp:", converted);
+      return converted;
+    }
+    if (timestamp && timestamp.toDate && typeof timestamp.toDate === "function") {
+      const converted = timestamp.toDate();
+      console.log("\u2705 Converted using toDate():", converted);
+      return converted;
+    }
+    if (timestamp instanceof Date) {
+      console.log("\u2705 Already a Date object:", timestamp);
+      return timestamp;
+    }
+    if (typeof timestamp === "string" || typeof timestamp === "number") {
+      const date = new Date(timestamp);
+      if (!isNaN(date.getTime())) {
+        console.log("\u2705 Converted from string/number:", date);
+        return date;
+      }
+    }
+    console.warn("\u26A0\uFE0F Could not convert timestamp, returning current date. Input was:", timestamp);
+    return /* @__PURE__ */ new Date();
+  }
+  /**
+   * Converts a Firestore document to a Review object with proper date handling
+   * @param docData The raw Firestore document data
+   * @returns A Review object with properly converted dates
+   */
+  convertDocToReview(docData) {
+    const review = docData;
+    review.createdAt = this.convertTimestamp(docData.createdAt);
+    review.updatedAt = this.convertTimestamp(docData.updatedAt);
+    if (review.clinicReview) {
+      review.clinicReview.createdAt = this.convertTimestamp(review.clinicReview.createdAt);
+      review.clinicReview.updatedAt = this.convertTimestamp(review.clinicReview.updatedAt);
+    }
+    if (review.practitionerReview) {
+      review.practitionerReview.createdAt = this.convertTimestamp(review.practitionerReview.createdAt);
+      review.practitionerReview.updatedAt = this.convertTimestamp(review.practitionerReview.updatedAt);
+    }
+    if (review.procedureReview) {
+      review.procedureReview.createdAt = this.convertTimestamp(review.procedureReview.createdAt);
+      review.procedureReview.updatedAt = this.convertTimestamp(review.procedureReview.updatedAt);
+    }
+    if (review.extendedProcedureReviews && Array.isArray(review.extendedProcedureReviews)) {
+      review.extendedProcedureReviews = review.extendedProcedureReviews.map((extReview) => ({
+        ...extReview,
+        createdAt: this.convertTimestamp(extReview.createdAt),
+        updatedAt: this.convertTimestamp(extReview.updatedAt)
+      }));
+    }
+    return review;
+  }
   /**
    * Creates a new review
    * @param data - The review data to create
@@ -18231,7 +18302,7 @@ var ReviewService = class extends BaseService {
       console.log("\u274C ReviewService.getReview - Review not found:", reviewId);
       return null;
     }
-    const review = { ...docSnap.data(), id: reviewId };
+    const review = { ...this.convertDocToReview(docSnap.data()), id: reviewId };
     try {
       const appointmentDoc = await (0, import_firestore56.getDoc)(
         (0, import_firestore56.doc)(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
@@ -18296,7 +18367,7 @@ var ReviewService = class extends BaseService {
   async getReviewsByPatient(patientId) {
     const q = (0, import_firestore56.query)((0, import_firestore56.collection)(this.db, REVIEWS_COLLECTION), (0, import_firestore56.where)("patientId", "==", patientId));
     const snapshot = await (0, import_firestore56.getDocs)(q);
-    const reviews = snapshot.docs.map((doc45) => doc45.data());
+    const reviews = snapshot.docs.map((doc45) => this.convertDocToReview(doc45.data()));
     const enhancedReviews = await Promise.all(
       reviews.map(async (review) => {
         try {
@@ -18351,8 +18422,8 @@ var ReviewService = class extends BaseService {
     );
     const snapshot = await (0, import_firestore56.getDocs)(q);
     const reviews = snapshot.docs.map((doc45) => {
-      const data = doc45.data();
-      return { ...data, id: doc45.id };
+      const review = this.convertDocToReview(doc45.data());
+      return { ...review, id: doc45.id };
     });
     console.log("\u{1F50D} ReviewService.getReviewsByClinic - Found reviews before enhancement:", {
       clinicId,
@@ -18427,8 +18498,8 @@ var ReviewService = class extends BaseService {
     );
     const snapshot = await (0, import_firestore56.getDocs)(q);
     const reviews = snapshot.docs.map((doc45) => {
-      const data = doc45.data();
-      return { ...data, id: doc45.id };
+      const review = this.convertDocToReview(doc45.data());
+      return { ...review, id: doc45.id };
     });
     console.log("\u{1F50D} ReviewService.getReviewsByPractitioner - Found reviews before enhancement:", {
       practitionerId,
@@ -18574,7 +18645,7 @@ var ReviewService = class extends BaseService {
     if (snapshot.empty) {
       return null;
     }
-    return snapshot.docs[0].data();
+    return this.convertDocToReview(snapshot.docs[0].data());
   }
   /**
    * Deletes a review

package/dist/index.mjs

@@ -18346,6 +18346,77 @@ var ReviewService = class extends BaseService {
   constructor(db, auth, app) {
     super(db, auth, app);
   }
+  /**
+   * Helper function to convert Firestore Timestamps to Date objects
+   * @param timestamp The timestamp to convert
+   * @returns A JavaScript Date object or null
+   */
+  convertTimestamp(timestamp) {
+    if (!timestamp) {
+      console.warn("\u26A0\uFE0F convertTimestamp received null/undefined timestamp");
+      return /* @__PURE__ */ new Date();
+    }
+    console.log("\u{1F50D} convertTimestamp input:", {
+      type: typeof timestamp,
+      value: timestamp,
+      hasToDate: (timestamp == null ? void 0 : timestamp.toDate) !== void 0,
+      hasIsTimestamp: (timestamp == null ? void 0 : timestamp.__isTimestamp) !== void 0,
+      hasSeconds: (timestamp == null ? void 0 : timestamp.seconds) !== void 0
+    });
+    if (timestamp && timestamp.__isTimestamp === true && typeof timestamp.seconds === "number") {
+      const converted = new Date(timestamp.seconds * 1e3 + (timestamp.nanoseconds || 0) / 1e6);
+      console.log("\u2705 Converted __isTimestamp:", converted);
+      return converted;
+    }
+    if (timestamp && timestamp.toDate && typeof timestamp.toDate === "function") {
+      const converted = timestamp.toDate();
+      console.log("\u2705 Converted using toDate():", converted);
+      return converted;
+    }
+    if (timestamp instanceof Date) {
+      console.log("\u2705 Already a Date object:", timestamp);
+      return timestamp;
+    }
+    if (typeof timestamp === "string" || typeof timestamp === "number") {
+      const date = new Date(timestamp);
+      if (!isNaN(date.getTime())) {
+        console.log("\u2705 Converted from string/number:", date);
+        return date;
+      }
+    }
+    console.warn("\u26A0\uFE0F Could not convert timestamp, returning current date. Input was:", timestamp);
+    return /* @__PURE__ */ new Date();
+  }
+  /**
+   * Converts a Firestore document to a Review object with proper date handling
+   * @param docData The raw Firestore document data
+   * @returns A Review object with properly converted dates
+   */
+  convertDocToReview(docData) {
+    const review = docData;
+    review.createdAt = this.convertTimestamp(docData.createdAt);
+    review.updatedAt = this.convertTimestamp(docData.updatedAt);
+    if (review.clinicReview) {
+      review.clinicReview.createdAt = this.convertTimestamp(review.clinicReview.createdAt);
+      review.clinicReview.updatedAt = this.convertTimestamp(review.clinicReview.updatedAt);
+    }
+    if (review.practitionerReview) {
+      review.practitionerReview.createdAt = this.convertTimestamp(review.practitionerReview.createdAt);
+      review.practitionerReview.updatedAt = this.convertTimestamp(review.practitionerReview.updatedAt);
+    }
+    if (review.procedureReview) {
+      review.procedureReview.createdAt = this.convertTimestamp(review.procedureReview.createdAt);
+      review.procedureReview.updatedAt = this.convertTimestamp(review.procedureReview.updatedAt);
+    }
+    if (review.extendedProcedureReviews && Array.isArray(review.extendedProcedureReviews)) {
+      review.extendedProcedureReviews = review.extendedProcedureReviews.map((extReview) => ({
+        ...extReview,
+        createdAt: this.convertTimestamp(extReview.createdAt),
+        updatedAt: this.convertTimestamp(extReview.updatedAt)
+      }));
+    }
+    return review;
+  }
   /**
    * Creates a new review
    * @param data - The review data to create
@@ -18489,7 +18560,7 @@ var ReviewService = class extends BaseService {
       console.log("\u274C ReviewService.getReview - Review not found:", reviewId);
       return null;
     }
-    const review = { ...docSnap.data(), id: reviewId };
+    const review = { ...this.convertDocToReview(docSnap.data()), id: reviewId };
     try {
       const appointmentDoc = await getDoc39(
         doc38(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
@@ -18554,7 +18625,7 @@ var ReviewService = class extends BaseService {
   async getReviewsByPatient(patientId) {
     const q = query32(collection32(this.db, REVIEWS_COLLECTION), where32("patientId", "==", patientId));
     const snapshot = await getDocs32(q);
-    const reviews = snapshot.docs.map((doc45) => doc45.data());
+    const reviews = snapshot.docs.map((doc45) => this.convertDocToReview(doc45.data()));
     const enhancedReviews = await Promise.all(
       reviews.map(async (review) => {
         try {
@@ -18609,8 +18680,8 @@ var ReviewService = class extends BaseService {
     );
     const snapshot = await getDocs32(q);
     const reviews = snapshot.docs.map((doc45) => {
-      const data = doc45.data();
-      return { ...data, id: doc45.id };
+      const review = this.convertDocToReview(doc45.data());
+      return { ...review, id: doc45.id };
     });
     console.log("\u{1F50D} ReviewService.getReviewsByClinic - Found reviews before enhancement:", {
       clinicId,
@@ -18685,8 +18756,8 @@ var ReviewService = class extends BaseService {
     );
     const snapshot = await getDocs32(q);
     const reviews = snapshot.docs.map((doc45) => {
-      const data = doc45.data();
-      return { ...data, id: doc45.id };
+      const review = this.convertDocToReview(doc45.data());
+      return { ...review, id: doc45.id };
     });
     console.log("\u{1F50D} ReviewService.getReviewsByPractitioner - Found reviews before enhancement:", {
       practitionerId,
@@ -18832,7 +18903,7 @@ var ReviewService = class extends BaseService {
     if (snapshot.empty) {
       return null;
     }
-    return snapshot.docs[0].data();
+    return this.convertDocToReview(snapshot.docs[0].data());
   }
   /**
    * Deletes a review

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.12.69",
+  "version": "1.12.71",
   "description": "Firebase authentication service with anonymous upgrade support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/services/reviews/TIMESTAMP_FIX.md

@@ -0,0 +1,65 @@
+# Review Date Timestamp Fix
+
+## Problem
+All reviews in the Patient App were displaying the same date (e.g., "September 26, 2025") regardless of when they were actually created. This was causing confusion as users couldn't distinguish between reviews from different dates.
+
+## Root Cause
+When fetching reviews from Firestore, the `createdAt` and `updatedAt` fields were Firestore Timestamp objects that weren't being properly converted to JavaScript Date objects. The code was using:
+
+```typescript
+const reviews = snapshot.docs.map(doc => doc.data() as Review);
+```
+
+This direct type casting doesn't convert Firestore Timestamps (which have `seconds` and `nanoseconds` properties) into proper Date objects, leading to inconsistent date handling across the application.
+
+## Solution
+Added two helper methods to the `ReviewService` class:
+
+### 1. `convertTimestamp(timestamp: any): Date`
+Converts various timestamp formats to JavaScript Date objects:
+- Firestore Timestamp with `__isTimestamp` flag
+- Firestore Timestamp with `toDate()` method
+- Regular Date objects
+- String or number timestamps
+- Fallback to current date for invalid inputs
+
+### 2. `convertDocToReview(docData: any): Review`
+Converts raw Firestore document data to a properly formatted Review object by:
+- Converting main review timestamps (`createdAt`, `updatedAt`)
+- Converting clinic review timestamps if present
+- Converting practitioner review timestamps if present
+- Converting procedure review timestamps if present
+- Converting extended procedure reviews timestamps if present
+
+## Changes Made
+
+### Files Modified
+- `Api/src/services/reviews/reviews.service.ts`
+
+### Methods Updated
+All review fetching methods now use `convertDocToReview()`:
+1. `getReviewsByPatient(patientId: string)` - Line 372
+2. `getReviewsByClinic(clinicId: string)` - Line 443
+3. `getReviewsByPractitioner(practitionerId: string)` - Line 538
+4. `getReview(reviewId: string)` - Line 285
+5. `getReviewByAppointment(appointmentId: string)` - Line 723
+
+## Package Version
+- **Published Version**: `@blackcode_sa/metaestetics-api@1.12.70`
+- **Change Type**: Patch (bug fix)
+
+## Apps Updated
+All apps have been updated to use version 1.12.70:
+- ✅ Mobile (Patient App)
+- ✅ DoctorMobile
+- ✅ ClinicApp
+
+## Testing
+After updating, verify that:
+1. Reviews display their actual creation dates
+2. Each review shows a different date (if created on different days)
+3. Dates are formatted correctly in the format: "Month Day, Year" (e.g., "September 26, 2025")
+
+## Impact
+This fix ensures that all review dates are properly displayed across all applications, allowing users to accurately track when feedback was submitted.
+

package/src/services/reviews/reviews.service.ts

@@ -29,6 +29,101 @@ export class ReviewService extends BaseService {
     super(db, auth, app);
   }
 
+  /**
+   * Helper function to convert Firestore Timestamps to Date objects
+   * @param timestamp The timestamp to convert
+   * @returns A JavaScript Date object or null
+   */
+  private convertTimestamp(timestamp: any): Date {
+    // Log what we receive for debugging
+    if (!timestamp) {
+      console.warn('⚠️ convertTimestamp received null/undefined timestamp');
+      return new Date();
+    }
+
+    console.log('🔍 convertTimestamp input:', {
+      type: typeof timestamp,
+      value: timestamp,
+      hasToDate: timestamp?.toDate !== undefined,
+      hasIsTimestamp: timestamp?.__isTimestamp !== undefined,
+      hasSeconds: timestamp?.seconds !== undefined,
+    });
+
+    // Firebase Timestamp object with __isTimestamp
+    if (timestamp && timestamp.__isTimestamp === true && typeof timestamp.seconds === 'number') {
+      const converted = new Date(timestamp.seconds * 1000 + (timestamp.nanoseconds || 0) / 1000000);
+      console.log('✅ Converted __isTimestamp:', converted);
+      return converted;
+    }
+
+    // Firebase Firestore Timestamp with toDate method
+    if (timestamp && timestamp.toDate && typeof timestamp.toDate === 'function') {
+      const converted = timestamp.toDate();
+      console.log('✅ Converted using toDate():', converted);
+      return converted;
+    }
+
+    // Already a Date object
+    if (timestamp instanceof Date) {
+      console.log('✅ Already a Date object:', timestamp);
+      return timestamp;
+    }
+
+    // String or number
+    if (typeof timestamp === 'string' || typeof timestamp === 'number') {
+      const date = new Date(timestamp);
+      if (!isNaN(date.getTime())) {
+        console.log('✅ Converted from string/number:', date);
+        return date;
+      }
+    }
+
+    console.warn('⚠️ Could not convert timestamp, returning current date. Input was:', timestamp);
+    return new Date();
+  }
+
+  /**
+   * Converts a Firestore document to a Review object with proper date handling
+   * @param docData The raw Firestore document data
+   * @returns A Review object with properly converted dates
+   */
+  private convertDocToReview(docData: any): Review {
+    const review = docData as Review;
+    
+    // Convert main review timestamps
+    review.createdAt = this.convertTimestamp(docData.createdAt);
+    review.updatedAt = this.convertTimestamp(docData.updatedAt);
+
+    // Convert clinic review timestamps if present
+    if (review.clinicReview) {
+      review.clinicReview.createdAt = this.convertTimestamp(review.clinicReview.createdAt);
+      review.clinicReview.updatedAt = this.convertTimestamp(review.clinicReview.updatedAt);
+    }
+
+    // Convert practitioner review timestamps if present
+    if (review.practitionerReview) {
+      review.practitionerReview.createdAt = this.convertTimestamp(review.practitionerReview.createdAt);
+      review.practitionerReview.updatedAt = this.convertTimestamp(review.practitionerReview.updatedAt);
+    }
+
+    // Convert procedure review timestamps if present
+    if (review.procedureReview) {
+      review.procedureReview.createdAt = this.convertTimestamp(review.procedureReview.createdAt);
+      review.procedureReview.updatedAt = this.convertTimestamp(review.procedureReview.updatedAt);
+    }
+
+    // Convert extended procedure reviews timestamps if present
+    if (review.extendedProcedureReviews && Array.isArray(review.extendedProcedureReviews)) {
+      review.extendedProcedureReviews = review.extendedProcedureReviews.map(extReview => ({
+        ...extReview,
+        createdAt: this.convertTimestamp(extReview.createdAt),
+        updatedAt: this.convertTimestamp(extReview.updatedAt),
+      }));
+    }
+
+    return review;
+  }
+
   /**
    * Creates a new review
    * @param data - The review data to create
@@ -206,7 +301,7 @@ export class ReviewService extends BaseService {
       return null;
     }
 
-    const review = { ...docSnap.data(), id: reviewId } as Review;
+    const review = { ...this.convertDocToReview(docSnap.data()), id: reviewId };
 
     try {
       // Fetch the associated appointment to enhance with entity names
@@ -293,7 +388,7 @@ export class ReviewService extends BaseService {
   async getReviewsByPatient(patientId: string): Promise<Review[]> {
     const q = query(collection(this.db, REVIEWS_COLLECTION), where('patientId', '==', patientId));
     const snapshot = await getDocs(q);
-    const reviews = snapshot.docs.map(doc => doc.data() as Review);
+    const reviews = snapshot.docs.map(doc => this.convertDocToReview(doc.data()));
 
     // Enhance reviews with entity names from appointments
     const enhancedReviews = await Promise.all(
@@ -364,8 +459,8 @@ export class ReviewService extends BaseService {
     );
     const snapshot = await getDocs(q);
     const reviews = snapshot.docs.map(doc => {
-      const data = doc.data() as Review;
-      return { ...data, id: doc.id };
+      const review = this.convertDocToReview(doc.data());
+      return { ...review, id: doc.id };
     });
 
     console.log('🔍 ReviewService.getReviewsByClinic - Found reviews before enhancement:', {
@@ -459,8 +554,8 @@ export class ReviewService extends BaseService {
     );
     const snapshot = await getDocs(q);
     const reviews = snapshot.docs.map(doc => {
-      const data = doc.data() as Review;
-      return { ...data, id: doc.id };
+      const review = this.convertDocToReview(doc.data());
+      return { ...review, id: doc.id };
     });
 
     console.log('🔍 ReviewService.getReviewsByPractitioner - Found reviews before enhancement:', {
@@ -644,7 +739,7 @@ export class ReviewService extends BaseService {
       return null;
     }
 
-    return snapshot.docs[0].data() as Review;
+    return this.convertDocToReview(snapshot.docs[0].data());
   }
 
   /**