@blackcode_sa/metaestetics-api 1.12.59 → 1.12.61

package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts

@@ -1,395 +1,395 @@
-import * as admin from "firebase-admin";
-import { BaseMailingService } from "../base.mailing.service";
-import { practitionerInvitationTemplate } from "./templates/invitation.template";
-import { Logger } from "../../logger";
-// Import specific types and collection constants
-import {
-  Practitioner,
-  PractitionerToken,
-  PRACTITIONERS_COLLECTION,
-  PractitionerTokenStatus,
-} from "../../../types/practitioner";
-import { Clinic, CLINICS_COLLECTION } from "../../../types/clinic";
-
-// Define a minimal interface for the mailgun.js client if not importing full types
-interface NewMailgunMessagesAPI {
-  create(domain: string, data: any): Promise<any>;
-}
-interface NewMailgunClient {
-  messages: NewMailgunMessagesAPI;
-}
-
-/**
- * Interface for the data required to send a practitioner invitation email
- */
-export interface PractitionerInviteEmailData {
-  /** The token object from the practitioner service */
-  token: {
-    id: string;
-    token: string;
-    practitionerId: string;
-    email: string;
-    clinicId: string;
-    expiresAt: admin.firestore.Timestamp;
-  };
-
-  /** Practitioner basic info */
-  practitioner: {
-    firstName: string;
-    lastName: string;
-  };
-
-  /** Clinic info */
-  clinic: {
-    name: string;
-    contactEmail: string;
-    contactName?: string;
-  };
-
-  /** Config options */
-  options?: {
-    registrationUrl?: string;
-    customSubject?: string;
-    fromAddress?: string;
-    mailgunDomain?: string;
-  };
-}
-
-/**
- * Service for sending practitioner invitation emails, updated for mailgun.js v10+
- */
-export class PractitionerInviteMailingService extends BaseMailingService {
-  private readonly DEFAULT_REGISTRATION_URL =
-    "https://metaesthetics.net/register";
-  private readonly DEFAULT_SUBJECT =
-    "You've Been Invited to Join as a Practitioner";
-  private readonly DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
-
-  /**
-   * Constructor for PractitionerInviteMailingService
-   * @param firestore Firestore instance provided by the caller
-   * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
-   */
-  constructor(
-    firestore: FirebaseFirestore.Firestore,
-    mailgunClient: NewMailgunClient
-  ) {
-    super(firestore, mailgunClient);
-  }
-
-  /**
-   * Sends a practitioner invitation email
-   * @param data The practitioner invitation data
-   * @returns Promise resolved when email is sent
-   */
-  async sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any> {
-    try {
-      Logger.info(
-        "[PractitionerInviteMailingService] Sending invitation email to",
-        data.token.email
-      );
-
-      // Format expiration date
-      const expirationDate = data.token.expiresAt
-        .toDate()
-        .toLocaleDateString("en-US", {
-          weekday: "long",
-          year: "numeric",
-          month: "long",
-          day: "numeric",
-        });
-
-      // Registration URL
-      const registrationUrl =
-        data.options?.registrationUrl || this.DEFAULT_REGISTRATION_URL;
-
-      // Contact information
-      const contactName = data.clinic.contactName || "Clinic Administrator";
-      const contactEmail = data.clinic.contactEmail;
-
-      // Subject line
-      const subject = data.options?.customSubject || this.DEFAULT_SUBJECT;
-
-      // Determine 'from' address
-      const fromAddress =
-        data.options?.fromAddress ||
-        `MetaEstetics <no-reply@${
-          data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN
-        }>`;
-
-      // Current year for copyright
-      const currentYear = new Date().getFullYear().toString();
-
-      // Practitioner full name
-      const practitionerName = `${data.practitioner.firstName} ${data.practitioner.lastName}`;
-
-      // Prepare template variables
-      const templateVariables = {
-        clinicName: data.clinic.name,
-        practitionerName,
-        inviteToken: data.token.token,
-        expirationDate,
-        registrationUrl,
-        contactName,
-        contactEmail,
-        currentYear,
-      };
-
-      // Debug log for template variables (excluding token for security)
-      Logger.info("[PractitionerInviteMailingService] Template variables:", {
-        clinicName: templateVariables.clinicName,
-        practitionerName: templateVariables.practitionerName,
-        expirationDate: templateVariables.expirationDate,
-        registrationUrl: templateVariables.registrationUrl,
-        contactName: templateVariables.contactName,
-        contactEmail: templateVariables.contactEmail,
-        // Don't log the invite token for security
-        hasInviteToken: !!templateVariables.inviteToken,
-      });
-
-      // Render HTML email
-      const html = this.renderTemplate(
-        practitionerInvitationTemplate,
-        templateVariables
-      );
-
-      // Data for the new sendEmail signature
-      const mailgunSendData = {
-        to: data.token.email,
-        from: fromAddress,
-        subject,
-        html,
-      };
-
-      // Determine the domain to use for sending
-      const domainToSendFrom =
-        data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
-
-      Logger.info(
-        "[PractitionerInviteMailingService] Sending email with data:",
-        {
-          domain: domainToSendFrom,
-          to: mailgunSendData.to,
-          from: mailgunSendData.from,
-          subject: mailgunSendData.subject,
-          hasHtml: !!mailgunSendData.html,
-        }
-      );
-
-      // Call the updated sendEmail method from BaseMailingService
-      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
-
-      // Log success
-      await this.logEmailAttempt(
-        {
-          to: data.token.email,
-          subject,
-          templateName: "practitioner_invitation",
-        },
-        true
-      );
-
-      return result;
-    } catch (error: any) {
-      Logger.error(
-        "[PractitionerInviteMailingService] Error sending invitation email:",
-        {
-          errorMessage: error.message,
-          errorDetails: error.details,
-          errorStatus: error.status,
-          stack: error.stack,
-        }
-      );
-
-      // Log failure
-      await this.logEmailAttempt(
-        {
-          to: data.token.email,
-          subject: data.options?.customSubject || this.DEFAULT_SUBJECT,
-          templateName: "practitioner_invitation",
-        },
-        false,
-        error
-      );
-
-      throw error;
-    }
-  }
-
-  /**
-   * Handles the practitioner token creation event from Cloud Functions
-   * Fetches necessary data using defined types and collection constants,
-   * and sends the invitation email.
-   * @param tokenData The fully typed token object including its id
-   * @param fromAddress The 'from' email address to use, obtained from config
-   * @param mailgunDomain The mailgun domain to use for sending
-   * @returns Promise resolved when the email is sent
-   */
-  async handleTokenCreationEvent(
-    tokenData: PractitionerToken,
-    mailgunConfig: {
-      fromAddress: string;
-      domain: string;
-      registrationUrl?: string;
-    }
-  ): Promise<void> {
-    try {
-      Logger.info(
-        "[PractitionerInviteMailingService] Handling token creation event for token:",
-        tokenData.id
-      );
-
-      // Validate token data
-      if (!tokenData || !tokenData.id || !tokenData.token || !tokenData.email) {
-        throw new Error(
-          `Invalid token data: Missing required properties. Token ID: ${tokenData?.id}`
-        );
-      }
-
-      if (!tokenData.practitionerId) {
-        throw new Error(
-          `Token ${tokenData.id} is missing practitionerId reference`
-        );
-      }
-
-      if (!tokenData.clinicId) {
-        throw new Error(`Token ${tokenData.id} is missing clinicId reference`);
-      }
-
-      if (!tokenData.expiresAt) {
-        throw new Error(`Token ${tokenData.id} is missing expiration date`);
-      }
-
-      // Validate token status (handle both enum and string values)
-      if (
-        tokenData.status !== PractitionerTokenStatus.ACTIVE &&
-        String(tokenData.status).toLowerCase() !== "active"
-      ) {
-        Logger.warn(
-          "[PractitionerInviteMailingService] Token is not active, skipping email.",
-          { tokenId: tokenData.id, status: tokenData.status }
-        );
-        return;
-      }
-
-      // Log token status to help with debugging
-      Logger.info(
-        `[PractitionerInviteMailingService] Token status validation:`,
-        {
-          tokenId: tokenData.id,
-          status: tokenData.status,
-          statusType: typeof tokenData.status,
-        }
-      );
-
-      // Get practitioner data using constant and type
-      Logger.info(
-        `[PractitionerInviteMailingService] Fetching practitioner data: ${tokenData.practitionerId}`
-      );
-      const practitionerRef = this.db
-        .collection(PRACTITIONERS_COLLECTION)
-        .doc(tokenData.practitionerId);
-      const practitionerDoc = await practitionerRef.get();
-
-      if (!practitionerDoc.exists) {
-        throw new Error(`Practitioner ${tokenData.practitionerId} not found`);
-      }
-
-      const practitionerData = practitionerDoc.data() as Practitioner;
-      if (!practitionerData || !practitionerData.basicInfo) {
-        throw new Error(
-          `Practitioner ${tokenData.practitionerId} has invalid data structure`
-        );
-      }
-
-      Logger.info(
-        `[PractitionerInviteMailingService] Practitioner found: ${practitionerData.basicInfo.firstName} ${practitionerData.basicInfo.lastName}`
-      );
-
-      // Get clinic data using constant and type
-      Logger.info(
-        `[PractitionerInviteMailingService] Fetching clinic data: ${tokenData.clinicId}`
-      );
-      const clinicRef = this.db
-        .collection(CLINICS_COLLECTION)
-        .doc(tokenData.clinicId);
-      const clinicDoc = await clinicRef.get();
-
-      if (!clinicDoc.exists) {
-        throw new Error(`Clinic ${tokenData.clinicId} not found`);
-      }
-
-      const clinicData = clinicDoc.data() as Clinic;
-      if (!clinicData || !clinicData.contactInfo) {
-        throw new Error(
-          `Clinic ${tokenData.clinicId} has invalid data structure`
-        );
-      }
-
-      Logger.info(
-        `[PractitionerInviteMailingService] Clinic found: ${clinicData.name}`
-      );
-
-      // Clinic model doesn't have contactPerson, only contactInfo
-      // So we'll use simple contact information from contactInfo
-
-      // Validate fromAddress
-      if (!mailgunConfig.fromAddress) {
-        Logger.warn(
-          "[PractitionerInviteMailingService] No fromAddress provided, using default"
-        );
-        mailgunConfig.fromAddress = `MetaEstetics <no-reply@${this.DEFAULT_MAILGUN_DOMAIN}>`;
-      }
-
-      // Prepare email data using typed data
-      const emailData: PractitionerInviteEmailData = {
-        token: {
-          id: tokenData.id,
-          token: tokenData.token,
-          practitionerId: tokenData.practitionerId,
-          email: tokenData.email,
-          clinicId: tokenData.clinicId,
-          expiresAt: tokenData.expiresAt,
-        },
-        practitioner: {
-          firstName: practitionerData.basicInfo.firstName || "",
-          lastName: practitionerData.basicInfo.lastName || "",
-        },
-        clinic: {
-          name: clinicData.name || "Medical Clinic",
-          contactEmail: clinicData.contactInfo.email || "contact@medclinic.com",
-          // Since there's no contactPerson in the Clinic model, we'll just use "Clinic Admin"
-          contactName: "Clinic Admin",
-        },
-        options: {
-          fromAddress: mailgunConfig.fromAddress,
-          mailgunDomain: mailgunConfig.domain,
-          registrationUrl: mailgunConfig.registrationUrl,
-        },
-      };
-
-      Logger.info(
-        "[PractitionerInviteMailingService] Email data prepared, sending invitation"
-      );
-
-      // Send the invitation email
-      await this.sendInvitationEmail(emailData);
-
-      Logger.info(
-        "[PractitionerInviteMailingService] Invitation email sent successfully"
-      );
-    } catch (error: any) {
-      Logger.error(
-        "[PractitionerInviteMailingService] Error handling token creation event:",
-        {
-          errorMessage: error.message,
-          errorDetails: error.details,
-          errorStatus: error.status,
-          stack: error.stack,
-          tokenId: tokenData?.id,
-        }
-      );
-      throw error;
-    }
-  }
-}
+import * as admin from "firebase-admin";
+import { BaseMailingService } from "../base.mailing.service";
+import { practitionerInvitationTemplate } from "./templates/invitation.template";
+import { Logger } from "../../logger";
+// Import specific types and collection constants
+import {
+  Practitioner,
+  PractitionerToken,
+  PRACTITIONERS_COLLECTION,
+  PractitionerTokenStatus,
+} from "../../../types/practitioner";
+import { Clinic, CLINICS_COLLECTION } from "../../../types/clinic";
+
+// Define a minimal interface for the mailgun.js client if not importing full types
+interface NewMailgunMessagesAPI {
+  create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+  messages: NewMailgunMessagesAPI;
+}
+
+/**
+ * Interface for the data required to send a practitioner invitation email
+ */
+export interface PractitionerInviteEmailData {
+  /** The token object from the practitioner service */
+  token: {
+    id: string;
+    token: string;
+    practitionerId: string;
+    email: string;
+    clinicId: string;
+    expiresAt: admin.firestore.Timestamp;
+  };
+
+  /** Practitioner basic info */
+  practitioner: {
+    firstName: string;
+    lastName: string;
+  };
+
+  /** Clinic info */
+  clinic: {
+    name: string;
+    contactEmail: string;
+    contactName?: string;
+  };
+
+  /** Config options */
+  options?: {
+    registrationUrl?: string;
+    customSubject?: string;
+    fromAddress?: string;
+    mailgunDomain?: string;
+  };
+}
+
+/**
+ * Service for sending practitioner invitation emails, updated for mailgun.js v10+
+ */
+export class PractitionerInviteMailingService extends BaseMailingService {
+  private readonly DEFAULT_REGISTRATION_URL =
+    "https://metaesthetics.net/register";
+  private readonly DEFAULT_SUBJECT =
+    "You've Been Invited to Join as a Practitioner";
+  private readonly DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
+
+  /**
+   * Constructor for PractitionerInviteMailingService
+   * @param firestore Firestore instance provided by the caller
+   * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
+   */
+  constructor(
+    firestore: FirebaseFirestore.Firestore,
+    mailgunClient: NewMailgunClient
+  ) {
+    super(firestore, mailgunClient);
+  }
+
+  /**
+   * Sends a practitioner invitation email
+   * @param data The practitioner invitation data
+   * @returns Promise resolved when email is sent
+   */
+  async sendInvitationEmail(data: PractitionerInviteEmailData): Promise<any> {
+    try {
+      Logger.info(
+        "[PractitionerInviteMailingService] Sending invitation email to",
+        data.token.email
+      );
+
+      // Format expiration date
+      const expirationDate = data.token.expiresAt
+        .toDate()
+        .toLocaleDateString("en-US", {
+          weekday: "long",
+          year: "numeric",
+          month: "long",
+          day: "numeric",
+        });
+
+      // Registration URL
+      const registrationUrl =
+        data.options?.registrationUrl || this.DEFAULT_REGISTRATION_URL;
+
+      // Contact information
+      const contactName = data.clinic.contactName || "Clinic Administrator";
+      const contactEmail = data.clinic.contactEmail;
+
+      // Subject line
+      const subject = data.options?.customSubject || this.DEFAULT_SUBJECT;
+
+      // Determine 'from' address
+      const fromAddress =
+        data.options?.fromAddress ||
+        `MetaEstetics <no-reply@${
+          data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN
+        }>`;
+
+      // Current year for copyright
+      const currentYear = new Date().getFullYear().toString();
+
+      // Practitioner full name
+      const practitionerName = `${data.practitioner.firstName} ${data.practitioner.lastName}`;
+
+      // Prepare template variables
+      const templateVariables = {
+        clinicName: data.clinic.name,
+        practitionerName,
+        inviteToken: data.token.token,
+        expirationDate,
+        registrationUrl,
+        contactName,
+        contactEmail,
+        currentYear,
+      };
+
+      // Debug log for template variables (excluding token for security)
+      Logger.info("[PractitionerInviteMailingService] Template variables:", {
+        clinicName: templateVariables.clinicName,
+        practitionerName: templateVariables.practitionerName,
+        expirationDate: templateVariables.expirationDate,
+        registrationUrl: templateVariables.registrationUrl,
+        contactName: templateVariables.contactName,
+        contactEmail: templateVariables.contactEmail,
+        // Don't log the invite token for security
+        hasInviteToken: !!templateVariables.inviteToken,
+      });
+
+      // Render HTML email
+      const html = this.renderTemplate(
+        practitionerInvitationTemplate,
+        templateVariables
+      );
+
+      // Data for the new sendEmail signature
+      const mailgunSendData = {
+        to: data.token.email,
+        from: fromAddress,
+        subject,
+        html,
+      };
+
+      // Determine the domain to use for sending
+      const domainToSendFrom =
+        data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
+
+      Logger.info(
+        "[PractitionerInviteMailingService] Sending email with data:",
+        {
+          domain: domainToSendFrom,
+          to: mailgunSendData.to,
+          from: mailgunSendData.from,
+          subject: mailgunSendData.subject,
+          hasHtml: !!mailgunSendData.html,
+        }
+      );
+
+      // Call the updated sendEmail method from BaseMailingService
+      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
+
+      // Log success
+      await this.logEmailAttempt(
+        {
+          to: data.token.email,
+          subject,
+          templateName: "practitioner_invitation",
+        },
+        true
+      );
+
+      return result;
+    } catch (error: any) {
+      Logger.error(
+        "[PractitionerInviteMailingService] Error sending invitation email:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack,
+        }
+      );
+
+      // Log failure
+      await this.logEmailAttempt(
+        {
+          to: data.token.email,
+          subject: data.options?.customSubject || this.DEFAULT_SUBJECT,
+          templateName: "practitioner_invitation",
+        },
+        false,
+        error
+      );
+
+      throw error;
+    }
+  }
+
+  /**
+   * Handles the practitioner token creation event from Cloud Functions
+   * Fetches necessary data using defined types and collection constants,
+   * and sends the invitation email.
+   * @param tokenData The fully typed token object including its id
+   * @param fromAddress The 'from' email address to use, obtained from config
+   * @param mailgunDomain The mailgun domain to use for sending
+   * @returns Promise resolved when the email is sent
+   */
+  async handleTokenCreationEvent(
+    tokenData: PractitionerToken,
+    mailgunConfig: {
+      fromAddress: string;
+      domain: string;
+      registrationUrl?: string;
+    }
+  ): Promise<void> {
+    try {
+      Logger.info(
+        "[PractitionerInviteMailingService] Handling token creation event for token:",
+        tokenData.id
+      );
+
+      // Validate token data
+      if (!tokenData || !tokenData.id || !tokenData.token || !tokenData.email) {
+        throw new Error(
+          `Invalid token data: Missing required properties. Token ID: ${tokenData?.id}`
+        );
+      }
+
+      if (!tokenData.practitionerId) {
+        throw new Error(
+          `Token ${tokenData.id} is missing practitionerId reference`
+        );
+      }
+
+      if (!tokenData.clinicId) {
+        throw new Error(`Token ${tokenData.id} is missing clinicId reference`);
+      }
+
+      if (!tokenData.expiresAt) {
+        throw new Error(`Token ${tokenData.id} is missing expiration date`);
+      }
+
+      // Validate token status (handle both enum and string values)
+      if (
+        tokenData.status !== PractitionerTokenStatus.ACTIVE &&
+        String(tokenData.status).toLowerCase() !== "active"
+      ) {
+        Logger.warn(
+          "[PractitionerInviteMailingService] Token is not active, skipping email.",
+          { tokenId: tokenData.id, status: tokenData.status }
+        );
+        return;
+      }
+
+      // Log token status to help with debugging
+      Logger.info(
+        `[PractitionerInviteMailingService] Token status validation:`,
+        {
+          tokenId: tokenData.id,
+          status: tokenData.status,
+          statusType: typeof tokenData.status,
+        }
+      );
+
+      // Get practitioner data using constant and type
+      Logger.info(
+        `[PractitionerInviteMailingService] Fetching practitioner data: ${tokenData.practitionerId}`
+      );
+      const practitionerRef = this.db
+        .collection(PRACTITIONERS_COLLECTION)
+        .doc(tokenData.practitionerId);
+      const practitionerDoc = await practitionerRef.get();
+
+      if (!practitionerDoc.exists) {
+        throw new Error(`Practitioner ${tokenData.practitionerId} not found`);
+      }
+
+      const practitionerData = practitionerDoc.data() as Practitioner;
+      if (!practitionerData || !practitionerData.basicInfo) {
+        throw new Error(
+          `Practitioner ${tokenData.practitionerId} has invalid data structure`
+        );
+      }
+
+      Logger.info(
+        `[PractitionerInviteMailingService] Practitioner found: ${practitionerData.basicInfo.firstName} ${practitionerData.basicInfo.lastName}`
+      );
+
+      // Get clinic data using constant and type
+      Logger.info(
+        `[PractitionerInviteMailingService] Fetching clinic data: ${tokenData.clinicId}`
+      );
+      const clinicRef = this.db
+        .collection(CLINICS_COLLECTION)
+        .doc(tokenData.clinicId);
+      const clinicDoc = await clinicRef.get();
+
+      if (!clinicDoc.exists) {
+        throw new Error(`Clinic ${tokenData.clinicId} not found`);
+      }
+
+      const clinicData = clinicDoc.data() as Clinic;
+      if (!clinicData || !clinicData.contactInfo) {
+        throw new Error(
+          `Clinic ${tokenData.clinicId} has invalid data structure`
+        );
+      }
+
+      Logger.info(
+        `[PractitionerInviteMailingService] Clinic found: ${clinicData.name}`
+      );
+
+      // Clinic model doesn't have contactPerson, only contactInfo
+      // So we'll use simple contact information from contactInfo
+
+      // Validate fromAddress
+      if (!mailgunConfig.fromAddress) {
+        Logger.warn(
+          "[PractitionerInviteMailingService] No fromAddress provided, using default"
+        );
+        mailgunConfig.fromAddress = `MetaEstetics <no-reply@${this.DEFAULT_MAILGUN_DOMAIN}>`;
+      }
+
+      // Prepare email data using typed data
+      const emailData: PractitionerInviteEmailData = {
+        token: {
+          id: tokenData.id,
+          token: tokenData.token,
+          practitionerId: tokenData.practitionerId,
+          email: tokenData.email,
+          clinicId: tokenData.clinicId,
+          expiresAt: tokenData.expiresAt,
+        },
+        practitioner: {
+          firstName: practitionerData.basicInfo.firstName || "",
+          lastName: practitionerData.basicInfo.lastName || "",
+        },
+        clinic: {
+          name: clinicData.name || "Medical Clinic",
+          contactEmail: clinicData.contactInfo.email || "contact@medclinic.com",
+          // Since there's no contactPerson in the Clinic model, we'll just use "Clinic Admin"
+          contactName: "Clinic Admin",
+        },
+        options: {
+          fromAddress: mailgunConfig.fromAddress,
+          mailgunDomain: mailgunConfig.domain,
+          registrationUrl: mailgunConfig.registrationUrl,
+        },
+      };
+
+      Logger.info(
+        "[PractitionerInviteMailingService] Email data prepared, sending invitation"
+      );
+
+      // Send the invitation email
+      await this.sendInvitationEmail(emailData);
+
+      Logger.info(
+        "[PractitionerInviteMailingService] Invitation email sent successfully"
+      );
+    } catch (error: any) {
+      Logger.error(
+        "[PractitionerInviteMailingService] Error handling token creation event:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack,
+          tokenId: tokenData?.id,
+        }
+      );
+      throw error;
+    }
+  }
+}