@blackcode_sa/metaestetics-api 1.7.33 → 1.7.35

package/package.json

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

package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts

@@ -10,9 +10,15 @@ import {
   PRACTITIONERS_COLLECTION,
   PractitionerClinicWorkingHours,
 } from "../../../types/practitioner";
-import { CLINICS_COLLECTION, Clinic } from "../../../types/clinic";
+import {
+  CLINICS_COLLECTION,
+  Clinic,
+  ClinicAdmin,
+  CLINIC_ADMINS_COLLECTION,
+} from "../../../types/clinic";
 import { ClinicInfo } from "../../../types/profile";
 import { Logger } from "../../logger";
+import { ExistingPractitionerInviteMailingService } from "../../mailing/practitionerInvite/existing-practitioner-invite.mailing";
 
 /**
  * @class PractitionerInviteAggregationService
@@ -22,13 +28,19 @@ import { Logger } from "../../logger";
  */
 export class PractitionerInviteAggregationService {
   private db: admin.firestore.Firestore;
+  private mailingService?: ExistingPractitionerInviteMailingService;
 
   /**
    * Constructor for PractitionerInviteAggregationService.
    * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
+   * @param mailingService Optional mailing service for sending emails
    */
-  constructor(firestore?: admin.firestore.Firestore) {
+  constructor(
+    firestore?: admin.firestore.Firestore,
+    mailingService?: ExistingPractitionerInviteMailingService
+  ) {
     this.db = firestore || admin.firestore();
+    this.mailingService = mailingService;
     Logger.info("[PractitionerInviteAggregationService] Initialized.");
   }
 
@@ -36,17 +48,49 @@ export class PractitionerInviteAggregationService {
    * Handles side effects when a practitioner invite is first created.
    * This function would typically be called by a Firestore onCreate trigger.
    * @param {PractitionerInvite} invite - The newly created PractitionerInvite object.
+   * @param {object} emailConfig - Optional email configuration for sending invite emails
    * @returns {Promise<void>}
    */
-  async handleInviteCreate(invite: PractitionerInvite): Promise<void> {
+  async handleInviteCreate(
+    invite: PractitionerInvite,
+    emailConfig?: {
+      fromAddress: string;
+      domain: string;
+      acceptUrl: string;
+      rejectUrl: string;
+    }
+  ): Promise<void> {
     Logger.info(
       `[PractitionerInviteAggService] Handling CREATE for invite: ${invite.id}, practitioner: ${invite.practitionerId}, clinic: ${invite.clinicId}, status: ${invite.status}`
     );
 
     try {
-      // TODO: Add any side effects needed when an invite is created
-      // For example: Send notification emails, update counters, etc.
-      // Currently, the main email sending is handled by the mailing service
+      // Send invitation email to practitioner if mailing service is available
+      if (
+        this.mailingService &&
+        emailConfig &&
+        invite.status === PractitionerInviteStatus.PENDING
+      ) {
+        Logger.info(
+          `[PractitionerInviteAggService] Sending invitation email for invite: ${invite.id}`
+        );
+
+        try {
+          await this.mailingService.handleInviteCreationEvent(
+            invite,
+            emailConfig
+          );
+          Logger.info(
+            `[PractitionerInviteAggService] Successfully sent invitation email for invite: ${invite.id}`
+          );
+        } catch (emailError) {
+          Logger.error(
+            `[PractitionerInviteAggService] Error sending invitation email for invite ${invite.id}:`,
+            emailError
+          );
+          // Don't throw - email failure shouldn't break the invite creation
+        }
+      }
 
       Logger.info(
         `[PractitionerInviteAggService] Successfully processed CREATE for invite: ${invite.id}`
@@ -65,11 +109,19 @@ export class PractitionerInviteAggregationService {
    * This function would typically be called by a Firestore onUpdate trigger.
    * @param {PractitionerInvite} before - The PractitionerInvite object before the update.
    * @param {PractitionerInvite} after - The PractitionerInvite object after the update.
+   * @param {object} emailConfig - Optional email configuration for sending notification emails
    * @returns {Promise<void>}
    */
   async handleInviteUpdate(
     before: PractitionerInvite,
-    after: PractitionerInvite
+    after: PractitionerInvite,
+    emailConfig?: {
+      fromAddress: string;
+      domain: string;
+      clinicDashboardUrl: string;
+      practitionerProfileUrl?: string;
+      findPractitionersUrl?: string;
+    }
   ): Promise<void> {
     Logger.info(
       `[PractitionerInviteAggService] Handling UPDATE for invite: ${after.id}. Status ${before.status} -> ${after.status}`
@@ -91,7 +143,7 @@ export class PractitionerInviteAggregationService {
           Logger.info(
             `[PractitionerInviteAggService] Invite ${after.id} PENDING -> ACCEPTED. Adding practitioner to clinic.`
           );
-          await this.handleInviteAccepted(after);
+          await this.handleInviteAccepted(after, emailConfig);
         }
 
         // Handle PENDING -> REJECTED
@@ -102,7 +154,7 @@ export class PractitionerInviteAggregationService {
           Logger.info(
             `[PractitionerInviteAggService] Invite ${after.id} PENDING -> REJECTED.`
           );
-          await this.handleInviteRejected(after);
+          await this.handleInviteRejected(after, emailConfig);
         }
 
         // Handle PENDING -> CANCELLED
@@ -162,10 +214,17 @@ export class PractitionerInviteAggregationService {
    * Handles the business logic when a practitioner accepts an invite.
    * This includes adding the practitioner to the clinic and the clinic to the practitioner.
    * @param {PractitionerInvite} invite - The accepted invite
+   * @param {object} emailConfig - Optional email configuration for sending notification emails
    * @returns {Promise<void>}
    */
   private async handleInviteAccepted(
-    invite: PractitionerInvite
+    invite: PractitionerInvite,
+    emailConfig?: {
+      fromAddress: string;
+      domain: string;
+      clinicDashboardUrl: string;
+      practitionerProfileUrl?: string;
+    }
   ): Promise<void> {
     Logger.info(
       `[PractitionerInviteAggService] Processing accepted invite ${invite.id} for practitioner ${invite.practitionerId} and clinic ${invite.clinicId}`
@@ -251,6 +310,31 @@ export class PractitionerInviteAggregationService {
         await this.updatePractitionerWorkingHours(practitioner.id, invite);
       }
 
+      // Send acceptance notification email to clinic admin if mailing service is available
+      if (this.mailingService && emailConfig) {
+        Logger.info(
+          `[PractitionerInviteAggService] Sending acceptance notification email for invite: ${invite.id}`
+        );
+
+        try {
+          await this.sendAcceptanceNotificationEmail(
+            invite,
+            practitioner,
+            clinic,
+            emailConfig
+          );
+          Logger.info(
+            `[PractitionerInviteAggService] Successfully sent acceptance notification email for invite: ${invite.id}`
+          );
+        } catch (emailError) {
+          Logger.error(
+            `[PractitionerInviteAggService] Error sending acceptance notification email for invite ${invite.id}:`,
+            emailError
+          );
+          // Don't throw - email failure shouldn't break the acceptance logic
+        }
+      }
+
       Logger.info(
         `[PractitionerInviteAggService] Successfully processed accepted invite ${invite.id}`
       );
@@ -266,18 +350,54 @@ export class PractitionerInviteAggregationService {
   /**
    * Handles the business logic when a practitioner rejects an invite.
    * @param {PractitionerInvite} invite - The rejected invite
+   * @param {object} emailConfig - Optional email configuration for sending notification emails
    * @returns {Promise<void>}
    */
   private async handleInviteRejected(
-    invite: PractitionerInvite
+    invite: PractitionerInvite,
+    emailConfig?: {
+      fromAddress: string;
+      domain: string;
+      clinicDashboardUrl: string;
+      findPractitionersUrl?: string;
+    }
   ): Promise<void> {
     Logger.info(
       `[PractitionerInviteAggService] Processing rejected invite ${invite.id}`
     );
 
     try {
-      // TODO: Add any side effects for rejected invites
-      // For example: Update counters, send notifications, etc.
+      // Send rejection notification email to clinic admin if mailing service is available
+      if (this.mailingService && emailConfig) {
+        Logger.info(
+          `[PractitionerInviteAggService] Sending rejection notification email for invite: ${invite.id}`
+        );
+
+        try {
+          const [practitioner, clinic] = await Promise.all([
+            this.fetchPractitionerById(invite.practitionerId),
+            this.fetchClinicById(invite.clinicId),
+          ]);
+
+          if (practitioner && clinic) {
+            await this.sendRejectionNotificationEmail(
+              invite,
+              practitioner,
+              clinic,
+              emailConfig
+            );
+            Logger.info(
+              `[PractitionerInviteAggService] Successfully sent rejection notification email for invite: ${invite.id}`
+            );
+          }
+        } catch (emailError) {
+          Logger.error(
+            `[PractitionerInviteAggService] Error sending rejection notification email for invite ${invite.id}:`,
+            emailError
+          );
+          // Don't throw - email failure shouldn't break the rejection logic
+        }
+      }
 
       Logger.info(
         `[PractitionerInviteAggService] Successfully processed rejected invite ${invite.id}`
@@ -530,6 +650,29 @@ export class PractitionerInviteAggregationService {
 
   // --- Data Fetching Helpers ---
 
+  /**
+   * Fetches a clinic admin by ID
+   * @param adminId The clinic admin ID
+   * @returns The clinic admin or null if not found
+   */
+  private async fetchClinicAdminById(
+    adminId: string
+  ): Promise<ClinicAdmin | null> {
+    try {
+      const doc = await this.db
+        .collection(CLINIC_ADMINS_COLLECTION)
+        .doc(adminId)
+        .get();
+      return doc.exists ? (doc.data() as ClinicAdmin) : null;
+    } catch (error) {
+      Logger.error(
+        `[PractitionerInviteAggService] Error fetching clinic admin ${adminId}:`,
+        error
+      );
+      return null;
+    }
+  }
+
   /**
    * Fetches a practitioner by ID.
    * @param practitionerId The practitioner ID.
@@ -573,4 +716,246 @@ export class PractitionerInviteAggregationService {
       return null;
     }
   }
+
+  // --- Email Helper Methods ---
+
+  /**
+   * Sends acceptance notification email to clinic admin
+   * @param invite The accepted invite
+   * @param practitioner The practitioner who accepted
+   * @param clinic The clinic that sent the invite
+   * @param emailConfig Email configuration
+   */
+  private async sendAcceptanceNotificationEmail(
+    invite: PractitionerInvite,
+    practitioner: Practitioner,
+    clinic: Clinic,
+    emailConfig: {
+      fromAddress: string;
+      domain: string;
+      clinicDashboardUrl: string;
+      practitionerProfileUrl?: string;
+    }
+  ): Promise<void> {
+    if (!this.mailingService) return;
+
+    try {
+      // Fetch the admin who created the invite
+      const admin = await this.fetchClinicAdminById(invite.invitedBy);
+      if (!admin) {
+        Logger.warn(
+          `[PractitionerInviteAggService] Admin ${invite.invitedBy} not found, using clinic contact email as fallback`
+        );
+
+        // Fallback to clinic contact email
+        const notificationData = {
+          invite,
+          practitioner: {
+            firstName: practitioner.basicInfo.firstName || "",
+            lastName: practitioner.basicInfo.lastName || "",
+            specialties:
+              practitioner.certification?.specialties?.map(
+                (s: any) => s.name || s
+              ) || [],
+            profileImageUrl:
+              typeof practitioner.basicInfo.profileImageUrl === "string"
+                ? practitioner.basicInfo.profileImageUrl
+                : null,
+            experienceYears: undefined,
+          },
+          clinic: {
+            name: clinic.name,
+            adminName: "Admin",
+            adminEmail: clinic.contactInfo.email,
+          },
+          context: {
+            invitationDate: invite.createdAt.toDate().toLocaleDateString(),
+            responseDate:
+              invite.acceptedAt?.toDate().toLocaleDateString() ||
+              new Date().toLocaleDateString(),
+          },
+          urls: {
+            clinicDashboardUrl: emailConfig.clinicDashboardUrl,
+            practitionerProfileUrl: emailConfig.practitionerProfileUrl,
+          },
+          options: {
+            fromAddress: emailConfig.fromAddress,
+            mailgunDomain: emailConfig.domain,
+          },
+        };
+
+        await this.mailingService.sendAcceptedNotificationEmail(
+          notificationData
+        );
+        return;
+      }
+
+      // Use specific admin details
+      const adminName = `${admin.contactInfo.firstName} ${admin.contactInfo.lastName}`;
+
+      const notificationData = {
+        invite,
+        practitioner: {
+          firstName: practitioner.basicInfo.firstName || "",
+          lastName: practitioner.basicInfo.lastName || "",
+          specialties:
+            practitioner.certification?.specialties?.map(
+              (s: any) => s.name || s
+            ) || [],
+          profileImageUrl:
+            typeof practitioner.basicInfo.profileImageUrl === "string"
+              ? practitioner.basicInfo.profileImageUrl
+              : null,
+          experienceYears: undefined, // This would need to be calculated or stored in practitioner data
+        },
+        clinic: {
+          name: clinic.name,
+          adminName: adminName,
+          adminEmail: admin.contactInfo.email, // Use the specific admin's email
+        },
+        context: {
+          invitationDate: invite.createdAt.toDate().toLocaleDateString(),
+          responseDate:
+            invite.acceptedAt?.toDate().toLocaleDateString() ||
+            new Date().toLocaleDateString(),
+        },
+        urls: {
+          clinicDashboardUrl: emailConfig.clinicDashboardUrl,
+          practitionerProfileUrl: emailConfig.practitionerProfileUrl,
+        },
+        options: {
+          fromAddress: emailConfig.fromAddress,
+          mailgunDomain: emailConfig.domain,
+        },
+      };
+
+      await this.mailingService.sendAcceptedNotificationEmail(notificationData);
+    } catch (error) {
+      Logger.error(
+        `[PractitionerInviteAggService] Error sending acceptance notification email:`,
+        error
+      );
+      throw error;
+    }
+  }
+
+  /**
+   * Sends rejection notification email to clinic admin
+   * @param invite The rejected invite
+   * @param practitioner The practitioner who rejected
+   * @param clinic The clinic that sent the invite
+   * @param emailConfig Email configuration
+   */
+  private async sendRejectionNotificationEmail(
+    invite: PractitionerInvite,
+    practitioner: Practitioner,
+    clinic: Clinic,
+    emailConfig: {
+      fromAddress: string;
+      domain: string;
+      clinicDashboardUrl: string;
+      findPractitionersUrl?: string;
+    }
+  ): Promise<void> {
+    if (!this.mailingService) return;
+
+    try {
+      // Fetch the admin who created the invite
+      const admin = await this.fetchClinicAdminById(invite.invitedBy);
+      if (!admin) {
+        Logger.warn(
+          `[PractitionerInviteAggService] Admin ${invite.invitedBy} not found, using clinic contact email as fallback`
+        );
+
+        // Fallback to clinic contact email
+        const notificationData = {
+          invite,
+          practitioner: {
+            firstName: practitioner.basicInfo.firstName || "",
+            lastName: practitioner.basicInfo.lastName || "",
+            specialties:
+              practitioner.certification?.specialties?.map(
+                (s: any) => s.name || s
+              ) || [],
+            profileImageUrl:
+              typeof practitioner.basicInfo.profileImageUrl === "string"
+                ? practitioner.basicInfo.profileImageUrl
+                : null,
+          },
+          clinic: {
+            name: clinic.name,
+            adminName: "Admin",
+            adminEmail: clinic.contactInfo.email,
+          },
+          context: {
+            invitationDate: invite.createdAt.toDate().toLocaleDateString(),
+            responseDate:
+              invite.rejectedAt?.toDate().toLocaleDateString() ||
+              new Date().toLocaleDateString(),
+            rejectionReason: invite.rejectionReason || undefined,
+          },
+          urls: {
+            clinicDashboardUrl: emailConfig.clinicDashboardUrl,
+            findPractitionersUrl: emailConfig.findPractitionersUrl,
+          },
+          options: {
+            fromAddress: emailConfig.fromAddress,
+            mailgunDomain: emailConfig.domain,
+          },
+        };
+
+        await this.mailingService.sendRejectedNotificationEmail(
+          notificationData
+        );
+        return;
+      }
+
+      // Use specific admin details
+      const adminName = `${admin.contactInfo.firstName} ${admin.contactInfo.lastName}`;
+
+      const notificationData = {
+        invite,
+        practitioner: {
+          firstName: practitioner.basicInfo.firstName || "",
+          lastName: practitioner.basicInfo.lastName || "",
+          specialties:
+            practitioner.certification?.specialties?.map(
+              (s: any) => s.name || s
+            ) || [],
+          profileImageUrl:
+            typeof practitioner.basicInfo.profileImageUrl === "string"
+              ? practitioner.basicInfo.profileImageUrl
+              : null,
+        },
+        clinic: {
+          name: clinic.name,
+          adminName: adminName,
+          adminEmail: admin.contactInfo.email, // Use the specific admin's email
+        },
+        context: {
+          invitationDate: invite.createdAt.toDate().toLocaleDateString(),
+          responseDate:
+            invite.rejectedAt?.toDate().toLocaleDateString() ||
+            new Date().toLocaleDateString(),
+          rejectionReason: invite.rejectionReason || undefined,
+        },
+        urls: {
+          clinicDashboardUrl: emailConfig.clinicDashboardUrl,
+          findPractitionersUrl: emailConfig.findPractitionersUrl,
+        },
+        options: {
+          fromAddress: emailConfig.fromAddress,
+          mailgunDomain: emailConfig.domain,
+        },
+      };
+
+      await this.mailingService.sendRejectedNotificationEmail(notificationData);
+    } catch (error) {
+      Logger.error(
+        `[PractitionerInviteAggService] Error sending rejection notification email:`,
+        error
+      );
+      throw error;
+    }
+  }
 }

package/src/admin/index.ts

@@ -33,6 +33,7 @@ import { ReviewsAggregationService } from "./aggregation/reviews/reviews.aggrega
 // Import mailing services
 import { BaseMailingService } from "./mailing/base.mailing.service";
 import { PractitionerInviteMailingService } from "./mailing/practitionerInvite/practitionerInvite.mailing";
+import { ExistingPractitionerInviteMailingService } from "./mailing/practitionerInvite/existing-practitioner-invite.mailing";
 
 // Import booking services
 import { BookingAdmin } from "./booking/booking.admin";
@@ -87,7 +88,17 @@ export {
 };
 
 // Export mailing services
-export { BaseMailingService, PractitionerInviteMailingService };
+export {
+  BaseMailingService,
+  PractitionerInviteMailingService,
+  ExistingPractitionerInviteMailingService,
+};
+
+// Export mailing service interfaces
+export type {
+  ExistingPractitionerInviteEmailData,
+  ClinicAdminNotificationData,
+} from "./mailing/practitionerInvite/existing-practitioner-invite.mailing";
 
 // Export booking services
 export { BookingAdmin };