@blackcode_sa/metaestetics-api 1.5.47 → 1.5.48

package/dist/admin/index.d.mts

@@ -1518,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

@@ -1518,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

@@ -1650,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
@@ -1692,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(

package/dist/admin/index.mjs

@@ -1609,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
@@ -1651,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(

package/package.json

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

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(