@blackcode_sa/metaestetics-api 1.12.21 → 1.12.22

package/dist/index.mjs

@@ -16491,7 +16491,17 @@ var ReviewService = class extends BaseService {
    * @returns The created review
    */
   async createReview(data, appointmentId) {
+    var _a, _b, _c, _d, _e, _f;
     try {
+      console.log("\u{1F50D} ReviewService.createReview - Input data:", {
+        appointmentId,
+        hasClinicReview: !!data.clinicReview,
+        hasPractitionerReview: !!data.practitionerReview,
+        hasProcedureReview: !!data.procedureReview,
+        practitionerId: (_a = data.practitionerReview) == null ? void 0 : _a.practitionerId,
+        clinicId: (_b = data.clinicReview) == null ? void 0 : _b.clinicId,
+        procedureId: (_c = data.procedureReview) == null ? void 0 : _c.procedureId
+      });
       const validatedData = createReviewSchema.parse(data);
       const ratings = [];
       if (data.clinicReview) {
@@ -16564,6 +16574,12 @@ var ReviewService = class extends BaseService {
         createdAt: serverTimestamp26(),
         updatedAt: serverTimestamp26()
       });
+      console.log("\u2705 ReviewService.createReview - Review saved to Firestore:", {
+        reviewId,
+        practitionerId: (_d = review.practitionerReview) == null ? void 0 : _d.practitionerId,
+        clinicId: (_e = review.clinicReview) == null ? void 0 : _e.clinicId,
+        procedureId: (_f = review.procedureReview) == null ? void 0 : _f.procedureId
+      });
       return review;
     } catch (error) {
       if (error instanceof z26.ZodError) {
@@ -16573,69 +16589,332 @@ var ReviewService = class extends BaseService {
     }
   }
   /**
-   * Gets a review by ID
+   * Gets a review by ID with enhanced entity names
    * @param reviewId The ID of the review to get
-   * @returns The review if found, null otherwise
+   * @returns The review with entity names if found, null otherwise
    */
   async getReview(reviewId) {
+    var _a, _b, _c;
+    console.log("\u{1F50D} ReviewService.getReview - Getting review:", reviewId);
     const docRef = doc31(this.db, REVIEWS_COLLECTION, reviewId);
     const docSnap = await getDoc33(docRef);
     if (!docSnap.exists()) {
+      console.log("\u274C ReviewService.getReview - Review not found:", reviewId);
       return null;
     }
-    return docSnap.data();
+    const review = { ...docSnap.data(), id: reviewId };
+    try {
+      const appointmentDoc = await getDoc33(
+        doc31(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
+      );
+      if (appointmentDoc.exists()) {
+        const appointment = appointmentDoc.data();
+        const enhancedReview = { ...review };
+        if (enhancedReview.clinicReview && appointment.clinicInfo) {
+          enhancedReview.clinicReview = {
+            ...enhancedReview.clinicReview,
+            clinicName: appointment.clinicInfo.name
+          };
+        }
+        if (enhancedReview.practitionerReview && appointment.practitionerInfo) {
+          enhancedReview.practitionerReview = {
+            ...enhancedReview.practitionerReview,
+            practitionerName: appointment.practitionerInfo.name
+          };
+        }
+        if (enhancedReview.procedureReview && appointment.procedureInfo) {
+          enhancedReview.procedureReview = {
+            ...enhancedReview.procedureReview,
+            procedureName: appointment.procedureInfo.name
+          };
+        }
+        if (appointment.patientInfo) {
+          enhancedReview.patientName = appointment.patientInfo.fullName;
+        }
+        console.log("\u2705 ReviewService.getReview - Enhanced review:", {
+          reviewId,
+          hasEntityNames: !!(((_a = enhancedReview.clinicReview) == null ? void 0 : _a.clinicName) || ((_b = enhancedReview.practitionerReview) == null ? void 0 : _b.practitionerName) || ((_c = enhancedReview.procedureReview) == null ? void 0 : _c.procedureName) || enhancedReview.patientName)
+        });
+        return enhancedReview;
+      }
+      console.log("\u26A0\uFE0F ReviewService.getReview - Appointment not found for review:", reviewId);
+      return review;
+    } catch (error) {
+      console.warn(`Failed to enhance review ${reviewId} with entity names:`, error);
+      return review;
+    }
   }
   /**
-   * Gets all reviews for a specific patient
+   * Gets all reviews for a specific patient with enhanced entity names
    * @param patientId The ID of the patient
-   * @returns Array of reviews for the patient
+   * @returns Array of reviews for the patient with clinic, practitioner, and procedure names
    */
   async getReviewsByPatient(patientId) {
-    const q = query31(
-      collection31(this.db, REVIEWS_COLLECTION),
-      where31("patientId", "==", patientId)
-    );
+    const q = query31(collection31(this.db, REVIEWS_COLLECTION), where31("patientId", "==", patientId));
     const snapshot = await getDocs31(q);
-    return snapshot.docs.map((doc38) => doc38.data());
+    const reviews = snapshot.docs.map((doc38) => doc38.data());
+    const enhancedReviews = await Promise.all(
+      reviews.map(async (review) => {
+        try {
+          const appointmentDoc = await getDoc33(
+            doc31(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
+          );
+          if (appointmentDoc.exists()) {
+            const appointment = appointmentDoc.data();
+            const enhancedReview = { ...review };
+            if (enhancedReview.clinicReview && appointment.clinicInfo) {
+              enhancedReview.clinicReview = {
+                ...enhancedReview.clinicReview,
+                clinicName: appointment.clinicInfo.name
+              };
+            }
+            if (enhancedReview.practitionerReview && appointment.practitionerInfo) {
+              enhancedReview.practitionerReview = {
+                ...enhancedReview.practitionerReview,
+                practitionerName: appointment.practitionerInfo.name
+              };
+            }
+            if (enhancedReview.procedureReview && appointment.procedureInfo) {
+              enhancedReview.procedureReview = {
+                ...enhancedReview.procedureReview,
+                procedureName: appointment.procedureInfo.name
+              };
+            }
+            if (appointment.patientInfo) {
+              enhancedReview.patientName = appointment.patientInfo.fullName;
+            }
+            return enhancedReview;
+          }
+          return review;
+        } catch (error) {
+          console.warn(`Failed to enhance review ${review.id} with entity names:`, error);
+          return review;
+        }
+      })
+    );
+    return enhancedReviews;
   }
   /**
-   * Gets all reviews for a specific clinic
+   * Gets all reviews for a specific clinic with enhanced entity names
    * @param clinicId The ID of the clinic
-   * @returns Array of reviews containing clinic reviews
+   * @returns Array of reviews containing clinic reviews with clinic, practitioner, and procedure names
    */
   async getReviewsByClinic(clinicId) {
+    console.log("\u{1F50D} ReviewService.getReviewsByClinic - Querying for clinic:", clinicId);
     const q = query31(
       collection31(this.db, REVIEWS_COLLECTION),
       where31("clinicReview.clinicId", "==", clinicId)
     );
     const snapshot = await getDocs31(q);
-    return snapshot.docs.map((doc38) => doc38.data());
+    const reviews = snapshot.docs.map((doc38) => {
+      const data = doc38.data();
+      return { ...data, id: doc38.id };
+    });
+    console.log("\u{1F50D} ReviewService.getReviewsByClinic - Found reviews before enhancement:", {
+      clinicId,
+      reviewCount: reviews.length,
+      reviewIds: reviews.map((r) => r.id)
+    });
+    const enhancedReviews = await Promise.all(
+      reviews.map(async (review) => {
+        try {
+          const appointmentDoc = await getDoc33(
+            doc31(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
+          );
+          if (appointmentDoc.exists()) {
+            const appointment = appointmentDoc.data();
+            const enhancedReview = { ...review };
+            if (enhancedReview.clinicReview && appointment.clinicInfo) {
+              enhancedReview.clinicReview = {
+                ...enhancedReview.clinicReview,
+                clinicName: appointment.clinicInfo.name
+              };
+            }
+            if (enhancedReview.practitionerReview && appointment.practitionerInfo) {
+              enhancedReview.practitionerReview = {
+                ...enhancedReview.practitionerReview,
+                practitionerName: appointment.practitionerInfo.name
+              };
+            }
+            if (enhancedReview.procedureReview && appointment.procedureInfo) {
+              enhancedReview.procedureReview = {
+                ...enhancedReview.procedureReview,
+                procedureName: appointment.procedureInfo.name
+              };
+            }
+            if (appointment.patientInfo) {
+              enhancedReview.patientName = appointment.patientInfo.fullName;
+            }
+            return enhancedReview;
+          }
+          return review;
+        } catch (error) {
+          console.warn(`Failed to enhance review ${review.id} with entity names:`, error);
+          return review;
+        }
+      })
+    );
+    console.log("\u2705 ReviewService.getReviewsByClinic - Enhanced reviews:", {
+      clinicId,
+      reviewCount: enhancedReviews.length,
+      reviewIds: enhancedReviews.map((r) => r.id),
+      hasEntityNames: enhancedReviews.some(
+        (r) => {
+          var _a, _b, _c;
+          return ((_a = r.clinicReview) == null ? void 0 : _a.clinicName) || ((_b = r.practitionerReview) == null ? void 0 : _b.practitionerName) || ((_c = r.procedureReview) == null ? void 0 : _c.procedureName) || r.patientName;
+        }
+      )
+    });
+    return enhancedReviews;
   }
   /**
-   * Gets all reviews for a specific practitioner
+   * Gets all reviews for a specific practitioner with enhanced entity names
    * @param practitionerId The ID of the practitioner
-   * @returns Array of reviews containing practitioner reviews
+   * @returns Array of reviews containing practitioner reviews with clinic, practitioner, and procedure names
    */
   async getReviewsByPractitioner(practitionerId) {
+    console.log(
+      "\u{1F50D} ReviewService.getReviewsByPractitioner - Querying for practitioner:",
+      practitionerId
+    );
     const q = query31(
       collection31(this.db, REVIEWS_COLLECTION),
       where31("practitionerReview.practitionerId", "==", practitionerId)
     );
     const snapshot = await getDocs31(q);
-    return snapshot.docs.map((doc38) => doc38.data());
+    const reviews = snapshot.docs.map((doc38) => {
+      const data = doc38.data();
+      return { ...data, id: doc38.id };
+    });
+    console.log("\u{1F50D} ReviewService.getReviewsByPractitioner - Found reviews before enhancement:", {
+      practitionerId,
+      reviewCount: reviews.length,
+      reviewIds: reviews.map((r) => r.id)
+    });
+    const enhancedReviews = await Promise.all(
+      reviews.map(async (review) => {
+        try {
+          const appointmentDoc = await getDoc33(
+            doc31(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
+          );
+          if (appointmentDoc.exists()) {
+            const appointment = appointmentDoc.data();
+            const enhancedReview = { ...review };
+            if (enhancedReview.clinicReview && appointment.clinicInfo) {
+              enhancedReview.clinicReview = {
+                ...enhancedReview.clinicReview,
+                clinicName: appointment.clinicInfo.name
+              };
+            }
+            if (enhancedReview.practitionerReview && appointment.practitionerInfo) {
+              enhancedReview.practitionerReview = {
+                ...enhancedReview.practitionerReview,
+                practitionerName: appointment.practitionerInfo.name
+              };
+            }
+            if (enhancedReview.procedureReview && appointment.procedureInfo) {
+              enhancedReview.procedureReview = {
+                ...enhancedReview.procedureReview,
+                procedureName: appointment.procedureInfo.name
+              };
+            }
+            if (appointment.patientInfo) {
+              enhancedReview.patientName = appointment.patientInfo.fullName;
+            }
+            return enhancedReview;
+          }
+          return review;
+        } catch (error) {
+          console.warn(`Failed to enhance review ${review.id} with entity names:`, error);
+          return review;
+        }
+      })
+    );
+    console.log("\u2705 ReviewService.getReviewsByPractitioner - Enhanced reviews:", {
+      practitionerId,
+      reviewCount: enhancedReviews.length,
+      reviewIds: enhancedReviews.map((r) => r.id),
+      hasEntityNames: enhancedReviews.some(
+        (r) => {
+          var _a, _b, _c;
+          return ((_a = r.clinicReview) == null ? void 0 : _a.clinicName) || ((_b = r.practitionerReview) == null ? void 0 : _b.practitionerName) || ((_c = r.procedureReview) == null ? void 0 : _c.procedureName);
+        }
+      )
+    });
+    return enhancedReviews;
   }
   /**
-   * Gets all reviews for a specific procedure
+   * Gets all reviews for a specific procedure with enhanced entity names
    * @param procedureId The ID of the procedure
-   * @returns Array of reviews containing procedure reviews
+   * @returns Array of reviews containing procedure reviews with clinic, practitioner, and procedure names
    */
   async getReviewsByProcedure(procedureId) {
+    console.log("\u{1F50D} ReviewService.getReviewsByProcedure - Querying for procedure:", procedureId);
     const q = query31(
       collection31(this.db, REVIEWS_COLLECTION),
       where31("procedureReview.procedureId", "==", procedureId)
     );
     const snapshot = await getDocs31(q);
-    return snapshot.docs.map((doc38) => doc38.data());
+    const reviews = snapshot.docs.map((doc38) => {
+      const data = doc38.data();
+      return { ...data, id: doc38.id };
+    });
+    console.log("\u{1F50D} ReviewService.getReviewsByProcedure - Found reviews before enhancement:", {
+      procedureId,
+      reviewCount: reviews.length,
+      reviewIds: reviews.map((r) => r.id)
+    });
+    const enhancedReviews = await Promise.all(
+      reviews.map(async (review) => {
+        try {
+          const appointmentDoc = await getDoc33(
+            doc31(this.db, APPOINTMENTS_COLLECTION, review.appointmentId)
+          );
+          if (appointmentDoc.exists()) {
+            const appointment = appointmentDoc.data();
+            const enhancedReview = { ...review };
+            if (enhancedReview.clinicReview && appointment.clinicInfo) {
+              enhancedReview.clinicReview = {
+                ...enhancedReview.clinicReview,
+                clinicName: appointment.clinicInfo.name
+              };
+            }
+            if (enhancedReview.practitionerReview && appointment.practitionerInfo) {
+              enhancedReview.practitionerReview = {
+                ...enhancedReview.practitionerReview,
+                practitionerName: appointment.practitionerInfo.name
+              };
+            }
+            if (enhancedReview.procedureReview && appointment.procedureInfo) {
+              enhancedReview.procedureReview = {
+                ...enhancedReview.procedureReview,
+                procedureName: appointment.procedureInfo.name
+              };
+            }
+            if (appointment.patientInfo) {
+              enhancedReview.patientName = appointment.patientInfo.fullName;
+            }
+            return enhancedReview;
+          }
+          return review;
+        } catch (error) {
+          console.warn(`Failed to enhance review ${review.id} with entity names:`, error);
+          return review;
+        }
+      })
+    );
+    console.log("\u2705 ReviewService.getReviewsByProcedure - Enhanced reviews:", {
+      procedureId,
+      reviewCount: enhancedReviews.length,
+      reviewIds: enhancedReviews.map((r) => r.id),
+      hasEntityNames: enhancedReviews.some(
+        (r) => {
+          var _a, _b, _c;
+          return ((_a = r.clinicReview) == null ? void 0 : _a.clinicName) || ((_b = r.practitionerReview) == null ? void 0 : _b.practitionerName) || ((_c = r.procedureReview) == null ? void 0 : _c.procedureName) || r.patientName;
+        }
+      )
+    });
+    return enhancedReviews;
   }
   /**
    * Gets all reviews for a specific appointment

package/package.json

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

package/src/services/reviews/README.md

@@ -0,0 +1,129 @@
+# Reviews Service - Enhanced with Entity Names
+
+## Overview
+
+The Reviews Service has been enhanced to automatically include entity names (clinic, practitioner, procedure, and patient names) in all review responses. This eliminates the need for frontend applications to make additional API calls to fetch entity details.
+
+## Enhanced Methods
+
+All review retrieval methods now include entity names from associated appointments:
+
+### 1. `getReview(reviewId: string)`
+- **Enhanced**: ✅ Returns single review with entity names
+- **Entity Names**: Clinic name, practitioner name, procedure name, patient name
+- **Source**: Fetched from associated appointment data
+
+### 2. `getReviewsByPatient(patientId: string)`
+- **Enhanced**: ✅ Returns patient reviews with entity names
+- **Entity Names**: Clinic name, practitioner name, procedure name, patient name
+- **Use Case**: Patient app - "My Reviews" screen
+
+### 3. `getReviewsByPractitioner(practitionerId: string)`
+- **Enhanced**: ✅ Returns practitioner reviews with entity names
+- **Entity Names**: Clinic name, practitioner name, procedure name, patient name
+- **Use Case**: Doctor app - "Reviews" screen
+
+### 4. `getReviewsByClinic(clinicId: string)`
+- **Enhanced**: ✅ Returns clinic reviews with entity names
+- **Entity Names**: Clinic name, practitioner name, procedure name, patient name
+- **Use Case**: Clinic dashboard - "Reviews" section
+
+### 5. `getReviewsByProcedure(procedureId: string)`
+- **Enhanced**: ✅ Returns procedure reviews with entity names
+- **Entity Names**: Clinic name, practitioner name, procedure name, patient name
+- **Use Case**: Procedure analytics and reporting
+
+## Enhanced Review Structure
+
+```typescript
+interface Review {
+  id: string;
+  appointmentId: string;
+  patientId: string;
+  patientName?: string; // 🆕 Enhanced field
+  createdAt: Date;
+  updatedAt: Date;
+  clinicReview?: {
+    // ... existing fields
+    clinicName?: string; // 🆕 Enhanced field
+  };
+  practitionerReview?: {
+    // ... existing fields
+    practitionerName?: string; // 🆕 Enhanced field
+  };
+  procedureReview?: {
+    // ... existing fields
+    procedureName?: string; // 🆕 Enhanced field
+  };
+  overallComment: string;
+  overallRating: number;
+}
+```
+
+## Data Sources
+
+Entity names are fetched from the associated appointment's aggregated information:
+
+- **Clinic Name**: `appointment.clinicInfo.name`
+- **Practitioner Name**: `appointment.practitionerInfo.name`
+- **Procedure Name**: `appointment.procedureInfo.name`
+- **Patient Name**: `appointment.patientInfo.fullName`
+
+## Error Handling
+
+- If appointment is not found, review is returned without enhancement
+- Individual enhancement failures are logged but don't break the entire operation
+- Graceful fallback ensures API reliability
+
+## Logging
+
+Enhanced logging provides detailed information about:
+- Query parameters
+- Number of reviews found
+- Enhancement success/failure
+- Entity names availability
+
+## Performance Considerations
+
+- Each review requires one additional Firestore read for appointment data
+- Enhancement is performed in parallel for multiple reviews
+- Consider caching strategies for high-volume applications
+
+## Migration Notes
+
+- **Backward Compatible**: Existing code continues to work
+- **Optional Fields**: All enhanced fields are optional
+- **No Breaking Changes**: API signature remains the same
+
+## Usage Examples
+
+### Doctor App - Reviews Screen
+```typescript
+const reviews = await reviewService.getReviewsByPractitioner(practitionerId);
+// Now includes practitioner names, clinic names, procedure names, and patient names
+```
+
+### Patient App - My Reviews
+```typescript
+const reviews = await reviewService.getReviewsByPatient(patientId);
+// Now includes all entity names for better UX
+```
+
+### Clinic Dashboard
+```typescript
+const reviews = await reviewService.getReviewsByClinic(clinicId);
+// Now includes practitioner and procedure names for each review
+```
+
+## Testing
+
+All enhanced methods include comprehensive logging for debugging:
+- Input parameters
+- Query results
+- Enhancement status
+- Entity name availability
+
+Monitor logs with:
+```bash
+firebase functions:log --only reviewService
+```