@blackcode_sa/metaestetics-api 1.7.33 → 1.7.34

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.7.33",
+  "version": "1.7.34",
   "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

@@ -13,6 +13,7 @@ import {
 import { CLINICS_COLLECTION, Clinic } 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 +23,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 +43,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 +104,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 +138,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 +149,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 +209,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 +305,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 +345,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}`
@@ -573,4 +688,124 @@ 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;
+
+    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: undefined, // This would need to be fetched from clinic admin data
+        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);
+  }
+
+  /**
+   * 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;
+
+    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: undefined, // This would need to be fetched from clinic admin data
+        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);
+  }
 }

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 };