@blackcode_sa/metaestetics-api 1.5.46 → 1.5.48

package/dist/admin/index.d.mts

@@ -737,6 +737,10 @@ interface PractitionerToken {
     expiresAt: Timestamp;
     usedBy?: string;
     usedAt?: Timestamp;
+    emailSent?: boolean;
+    emailSentAt?: Timestamp;
+    emailError?: string;
+    emailErrorAt?: Timestamp;
 }
 
 /**
@@ -1514,6 +1518,11 @@ declare class BaseMailingService {
      * @param mailgunClient Mailgun client instance provided by the caller
      */
     constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    /**
+     * Validates that the Mailgun client is configured correctly
+     * Particularly checks for EU region configuration
+     */
+    private validateMailgunClient;
     /**
      * Sends an email using Mailgun
      * @param data Email data to send, including the 'from' address

package/dist/admin/index.d.ts

@@ -737,6 +737,10 @@ interface PractitionerToken {
     expiresAt: Timestamp;
     usedBy?: string;
     usedAt?: Timestamp;
+    emailSent?: boolean;
+    emailSentAt?: Timestamp;
+    emailError?: string;
+    emailErrorAt?: Timestamp;
 }
 
 /**
@@ -1514,6 +1518,11 @@ declare class BaseMailingService {
      * @param mailgunClient Mailgun client instance provided by the caller
      */
     constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: mailgun.Mailgun);
+    /**
+     * Validates that the Mailgun client is configured correctly
+     * Particularly checks for EU region configuration
+     */
+    private validateMailgunClient;
     /**
      * Sends an email using Mailgun
      * @param data Email data to send, including the 'from' address

package/dist/admin/index.js

@@ -40,6 +40,7 @@ __export(index_exports, {
   PatientAggregationService: () => PatientAggregationService,
   PractitionerAggregationService: () => PractitionerAggregationService,
   PractitionerInviteMailingService: () => PractitionerInviteMailingService,
+  PractitionerTokenStatus: () => PractitionerTokenStatus,
   ProcedureAggregationService: () => ProcedureAggregationService,
   UserRole: () => UserRole
 });
@@ -238,6 +239,13 @@ var admin2 = __toESM(require("firebase-admin"));
 
 // src/types/practitioner/index.ts
 var PRACTITIONERS_COLLECTION = "practitioners";
+var PractitionerTokenStatus = /* @__PURE__ */ ((PractitionerTokenStatus2) => {
+  PractitionerTokenStatus2["ACTIVE"] = "active";
+  PractitionerTokenStatus2["USED"] = "used";
+  PractitionerTokenStatus2["EXPIRED"] = "expired";
+  PractitionerTokenStatus2["REVOKED"] = "revoked";
+  return PractitionerTokenStatus2;
+})(PractitionerTokenStatus || {});
 
 // src/types/procedure/index.ts
 var PROCEDURES_COLLECTION = "procedures";
@@ -1642,8 +1650,34 @@ var BaseMailingService = class {
       Logger.error("[BaseMailingService] No Mailgun client provided");
       throw new Error("Mailgun client is required");
     }
+    this.validateMailgunClient();
     Logger.info("[BaseMailingService] Service initialized successfully");
   }
+  /**
+   * Validates that the Mailgun client is configured correctly
+   * Particularly checks for EU region configuration
+   */
+  validateMailgunClient() {
+    try {
+      const clientOptions = this.mailgunClient.options || {};
+      const host = clientOptions.host || "";
+      const isEuRegion = host.includes("eu.mailgun.net");
+      Logger.info("[BaseMailingService] Mailgun client configuration:", {
+        host: host || "default",
+        isEuRegion,
+        domain: clientOptions.domain || "unknown"
+      });
+      if (clientOptions.domain && clientOptions.domain.endsWith(".eu") && !isEuRegion) {
+        Logger.warn(
+          "[BaseMailingService] Domain appears to be in EU region but not using EU endpoint. If you're getting 401 Forbidden errors, ensure the host is set to 'api.eu.mailgun.net'"
+        );
+      }
+    } catch (error) {
+      Logger.warn("[BaseMailingService] Could not validate Mailgun client:", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
   /**
    * Sends an email using Mailgun
    * @param data Email data to send, including the 'from' address
@@ -1684,10 +1718,25 @@ var BaseMailingService = class {
             }
             messagesApi.send(data, (error, body) => {
               if (error) {
-                Logger.error("[BaseMailingService] Mailgun API error:", {
-                  error: error instanceof Error ? error.message : error,
-                  stack: error instanceof Error ? error.stack : void 0
-                });
+                if (error.statusCode === 401 || error.statusCode === 403) {
+                  const clientOptions = this.mailgunClient.options || {};
+                  Logger.error(
+                    "[BaseMailingService] Mailgun authentication error - possible region mismatch:",
+                    {
+                      error: error instanceof Error ? error.message : error,
+                      statusCode: error.statusCode,
+                      domain: clientOptions.domain || "unknown",
+                      host: clientOptions.host || "default api.mailgun.net",
+                      suggestion: "If using EU region domains, ensure host is set to 'api.eu.mailgun.net'"
+                    }
+                  );
+                } else {
+                  Logger.error("[BaseMailingService] Mailgun API error:", {
+                    error: error instanceof Error ? error.message : error,
+                    statusCode: error.statusCode,
+                    stack: error instanceof Error ? error.stack : void 0
+                  });
+                }
                 reject(error);
               } else {
                 Logger.info(
@@ -2009,6 +2058,17 @@ var PractitionerInviteMailingService = class extends BaseMailingService {
       if (!tokenData.expiresAt) {
         throw new Error(`Token ${tokenData.id} is missing expiration date`);
       }
+      if (!tokenData.status) {
+        throw new Error(`Token ${tokenData.id} has no status defined`);
+      }
+      Logger.info(
+        `[PractitionerInviteMailingService] Token status validation:`,
+        {
+          tokenId: tokenData.id,
+          status: tokenData.status,
+          statusType: typeof tokenData.status
+        }
+      );
       Logger.info(
         `[PractitionerInviteMailingService] Fetching practitioner data: ${tokenData.practitionerId}`
       );
@@ -2696,6 +2756,7 @@ console.log("[Admin Module] Initialized and services exported.");
   PatientAggregationService,
   PractitionerAggregationService,
   PractitionerInviteMailingService,
+  PractitionerTokenStatus,
   ProcedureAggregationService,
   UserRole
 });

package/dist/admin/index.mjs

@@ -198,6 +198,13 @@ import * as admin2 from "firebase-admin";
 
 // src/types/practitioner/index.ts
 var PRACTITIONERS_COLLECTION = "practitioners";
+var PractitionerTokenStatus = /* @__PURE__ */ ((PractitionerTokenStatus2) => {
+  PractitionerTokenStatus2["ACTIVE"] = "active";
+  PractitionerTokenStatus2["USED"] = "used";
+  PractitionerTokenStatus2["EXPIRED"] = "expired";
+  PractitionerTokenStatus2["REVOKED"] = "revoked";
+  return PractitionerTokenStatus2;
+})(PractitionerTokenStatus || {});
 
 // src/types/procedure/index.ts
 var PROCEDURES_COLLECTION = "procedures";
@@ -1602,8 +1609,34 @@ var BaseMailingService = class {
       Logger.error("[BaseMailingService] No Mailgun client provided");
       throw new Error("Mailgun client is required");
     }
+    this.validateMailgunClient();
     Logger.info("[BaseMailingService] Service initialized successfully");
   }
+  /**
+   * Validates that the Mailgun client is configured correctly
+   * Particularly checks for EU region configuration
+   */
+  validateMailgunClient() {
+    try {
+      const clientOptions = this.mailgunClient.options || {};
+      const host = clientOptions.host || "";
+      const isEuRegion = host.includes("eu.mailgun.net");
+      Logger.info("[BaseMailingService] Mailgun client configuration:", {
+        host: host || "default",
+        isEuRegion,
+        domain: clientOptions.domain || "unknown"
+      });
+      if (clientOptions.domain && clientOptions.domain.endsWith(".eu") && !isEuRegion) {
+        Logger.warn(
+          "[BaseMailingService] Domain appears to be in EU region but not using EU endpoint. If you're getting 401 Forbidden errors, ensure the host is set to 'api.eu.mailgun.net'"
+        );
+      }
+    } catch (error) {
+      Logger.warn("[BaseMailingService] Could not validate Mailgun client:", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
   /**
    * Sends an email using Mailgun
    * @param data Email data to send, including the 'from' address
@@ -1644,10 +1677,25 @@ var BaseMailingService = class {
             }
             messagesApi.send(data, (error, body) => {
               if (error) {
-                Logger.error("[BaseMailingService] Mailgun API error:", {
-                  error: error instanceof Error ? error.message : error,
-                  stack: error instanceof Error ? error.stack : void 0
-                });
+                if (error.statusCode === 401 || error.statusCode === 403) {
+                  const clientOptions = this.mailgunClient.options || {};
+                  Logger.error(
+                    "[BaseMailingService] Mailgun authentication error - possible region mismatch:",
+                    {
+                      error: error instanceof Error ? error.message : error,
+                      statusCode: error.statusCode,
+                      domain: clientOptions.domain || "unknown",
+                      host: clientOptions.host || "default api.mailgun.net",
+                      suggestion: "If using EU region domains, ensure host is set to 'api.eu.mailgun.net'"
+                    }
+                  );
+                } else {
+                  Logger.error("[BaseMailingService] Mailgun API error:", {
+                    error: error instanceof Error ? error.message : error,
+                    statusCode: error.statusCode,
+                    stack: error instanceof Error ? error.stack : void 0
+                  });
+                }
                 reject(error);
               } else {
                 Logger.info(
@@ -1969,6 +2017,17 @@ var PractitionerInviteMailingService = class extends BaseMailingService {
       if (!tokenData.expiresAt) {
         throw new Error(`Token ${tokenData.id} is missing expiration date`);
       }
+      if (!tokenData.status) {
+        throw new Error(`Token ${tokenData.id} has no status defined`);
+      }
+      Logger.info(
+        `[PractitionerInviteMailingService] Token status validation:`,
+        {
+          tokenId: tokenData.id,
+          status: tokenData.status,
+          statusType: typeof tokenData.status
+        }
+      );
       Logger.info(
         `[PractitionerInviteMailingService] Fetching practitioner data: ${tokenData.practitionerId}`
       );
@@ -2655,6 +2714,7 @@ export {
   PatientAggregationService,
   PractitionerAggregationService,
   PractitionerInviteMailingService,
+  PractitionerTokenStatus,
   ProcedureAggregationService,
   UserRole
 };

package/dist/index.d.mts

@@ -1530,6 +1530,10 @@ interface PractitionerToken {
     expiresAt: Timestamp;
     usedBy?: string;
     usedAt?: Timestamp;
+    emailSent?: boolean;
+    emailSentAt?: Timestamp;
+    emailError?: string;
+    emailErrorAt?: Timestamp;
 }
 /**
  * Tip za kreiranje tokena za zdravstvenog radnika

package/dist/index.d.ts

@@ -1530,6 +1530,10 @@ interface PractitionerToken {
     expiresAt: Timestamp;
     usedBy?: string;
     usedAt?: Timestamp;
+    emailSent?: boolean;
+    emailSentAt?: Timestamp;
+    emailError?: string;
+    emailErrorAt?: Timestamp;
 }
 /**
  * Tip za kreiranje tokena za zdravstvenog radnika

package/package.json

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

package/src/admin/index.ts

@@ -43,11 +43,7 @@ export type {
 // Re-export types needed by cloud functions
 export type { Clinic, ClinicLocation } from "../types/clinic";
 export type { ClinicInfo } from "../types/profile";
-export type {
-  Practitioner,
-  PractitionerToken,
-  PractitionerTokenStatus,
-} from "../types/practitioner";
+export type { Practitioner, PractitionerToken } from "../types/practitioner";
 export type { DoctorInfo } from "../types/clinic";
 export type { Procedure, ProcedureSummaryInfo } from "../types/procedure";
 export type { PatientProfile as Patient } from "../types/patient";
@@ -59,6 +55,7 @@ export {
   NOTIFICATIONS_COLLECTION,
 } from "../types/notifications";
 export { UserRole } from "../types";
+export { PractitionerTokenStatus } from "../types/practitioner";
 
 // Export admin classes/services explicitly by name
 export {

package/src/admin/mailing/base.mailing.service.ts

@@ -40,10 +40,49 @@ export class BaseMailingService {
       throw new Error("Mailgun client is required");
     }
 
+    // Validate the Mailgun client configuration
+    this.validateMailgunClient();
+
     // Log successful initialization
     Logger.info("[BaseMailingService] Service initialized successfully");
   }
 
+  /**
+   * Validates that the Mailgun client is configured correctly
+   * Particularly checks for EU region configuration
+   */
+  private validateMailgunClient(): void {
+    try {
+      // Access the host property to check if it's configured for EU region
+      const clientOptions = (this.mailgunClient as any).options || {};
+      const host = clientOptions.host || "";
+      const isEuRegion = host.includes("eu.mailgun.net");
+
+      Logger.info("[BaseMailingService] Mailgun client configuration:", {
+        host: host || "default",
+        isEuRegion,
+        domain: clientOptions.domain || "unknown",
+      });
+
+      // Check if this appears to be an EU domain but not using EU endpoint
+      if (
+        clientOptions.domain &&
+        clientOptions.domain.endsWith(".eu") &&
+        !isEuRegion
+      ) {
+        Logger.warn(
+          "[BaseMailingService] Domain appears to be in EU region but not using EU endpoint. " +
+            "If you're getting 401 Forbidden errors, ensure the host is set to 'api.eu.mailgun.net'"
+        );
+      }
+    } catch (error) {
+      // Just log the error, don't throw
+      Logger.warn("[BaseMailingService] Could not validate Mailgun client:", {
+        error: error instanceof Error ? error.message : String(error),
+      });
+    }
+  }
+
   /**
    * Sends an email using Mailgun
    * @param data Email data to send, including the 'from' address
@@ -97,10 +136,28 @@ export class BaseMailingService {
 
             messagesApi.send(data, (error, body) => {
               if (error) {
-                Logger.error("[BaseMailingService] Mailgun API error:", {
-                  error: error instanceof Error ? error.message : error,
-                  stack: error instanceof Error ? error.stack : undefined,
-                });
+                // Enhanced error logging for auth/region issues
+                if (error.statusCode === 401 || error.statusCode === 403) {
+                  const clientOptions =
+                    (this.mailgunClient as any).options || {};
+                  Logger.error(
+                    "[BaseMailingService] Mailgun authentication error - possible region mismatch:",
+                    {
+                      error: error instanceof Error ? error.message : error,
+                      statusCode: error.statusCode,
+                      domain: clientOptions.domain || "unknown",
+                      host: clientOptions.host || "default api.mailgun.net",
+                      suggestion:
+                        "If using EU region domains, ensure host is set to 'api.eu.mailgun.net'",
+                    }
+                  );
+                } else {
+                  Logger.error("[BaseMailingService] Mailgun API error:", {
+                    error: error instanceof Error ? error.message : error,
+                    statusCode: error.statusCode,
+                    stack: error instanceof Error ? error.stack : undefined,
+                  });
+                }
                 reject(error);
               } else {
                 Logger.info(

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

@@ -238,6 +238,21 @@ export class PractitionerInviteMailingService extends BaseMailingService {
         throw new Error(`Token ${tokenData.id} is missing expiration date`);
       }
 
+      // Validate token status (handle both enum and string values)
+      if (!tokenData.status) {
+        throw new Error(`Token ${tokenData.id} has no status defined`);
+      }
+
+      // 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}`

package/src/types/practitioner/index.ts

@@ -183,6 +183,11 @@ export interface PractitionerToken {
   expiresAt: Timestamp;
   usedBy?: string;
   usedAt?: Timestamp;
+  // Email tracking fields added by Cloud Function
+  emailSent?: boolean;
+  emailSentAt?: Timestamp;
+  emailError?: string;
+  emailErrorAt?: Timestamp;
 }
 
 /**