Official Mailgun SDK + EU host support (#2303)

waspc/data/Generator/templates/sdk/wasp/server/email/core/providers/mailgun.ts

@@ -1,22 +1,31 @@
-import { NodeMailgun } from "ts-mailgun";
+import Mailgun from 'mailgun.js';
 import { getDefaultFromField } from "../helpers.js";
 import type { MailgunEmailProvider, EmailSender } from "../types";
 
 // PRIVATE API
 export function initMailgunEmailSender(
   config: MailgunEmailProvider
 ): EmailSender {
-  const mailer = new NodeMailgun(config.apiKey, config.domain);
-
   const defaultFromField = getDefaultFromField();
 
+  const mailgun = new Mailgun(FormData);
+
+  const mailer = mailgun.client({
+    username: 'api',
+    key: config.apiKey,
+    url: config.apiUrl,
+  });
+
   return {
     async send(email) {
       const fromField = email.from || defaultFromField;
-      mailer.fromEmail = fromField.email;
-      mailer.fromTitle = fromField.name;
-      mailer.init();
-      return mailer.send(email.to, email.subject, email.html);
+      return mailer.messages.create(config.domain, {
+        from: `${fromField.name} <${fromField.email}>`,
+        to: [email.to],
+        subject: email.subject,
+        text: email.text,
+        html: email.html,
+      })
     },
   };
 }

waspc/data/Generator/templates/sdk/wasp/server/email/core/types.ts

@@ -22,6 +22,7 @@ export type MailgunEmailProvider = {
   type: "mailgun";
   apiKey: string;
   domain: string;
+  apiUrl?: string;
 };
 
 // PRIVATE API

waspc/data/Generator/templates/sdk/wasp/server/email/index.ts

@@ -22,6 +22,7 @@ const emailProvider = {
   type: "mailgun",
   apiKey: process.env.MAILGUN_API_KEY,
   domain: process.env.MAILGUN_DOMAIN,
+  apiUrl: process.env.MAILGUN_API_URL,
 } as const;
 {=/ isMailgunProviderUsed =}
 {=# isDummyProviderUsed =}

waspc/src/Wasp/Generator/SdkGenerator/EmailSender/Providers.hs

@@ -64,10 +64,10 @@ mailgun =
     }
   where
     mailgunVersionRange :: SV.Range
-    mailgunVersionRange = SV.Range [SV.backwardsCompatibleWith (SV.Version 0 5 1)]
+    mailgunVersionRange = SV.Range [SV.backwardsCompatibleWith (SV.Version 10 2 3)]
 
     mailgunDependency :: AS.Dependency.Dependency
-    mailgunDependency = AS.Dependency.make ("ts-mailgun", show mailgunVersionRange)
+    mailgunDependency = AS.Dependency.make ("mailgun.js", show mailgunVersionRange)
 
 dummy :: EmailSenderProvider
 dummy =

web/docs/advanced/email/email.md

@@ -222,16 +222,25 @@ Then, get the Mailgun API key and domain and add them to your `.env.server` file
 #### Getting the API Key and Domain
 
 1. Go to [Mailgun](https://www.mailgun.com/) and create an account.
-2. Go to [API Keys](https://app.mailgun.com/app/account/security/api_keys) and create a new API key.
-3. Copy the API key and add it to your `.env.server` file.
-4. Go to [Domains](https://app.mailgun.com/mg/sending/domains) and create a new domain.
-5. Copy the domain and add it to your `.env.server` file.
+1. Go to [Domains](https://app.mailgun.com/mg/sending/new-domain) and create a new domain.
+1. Copy the domain and add it to your `.env.server` file.
+1. Create a new Sending API key under `Send > Sending > Domain settings` and find `Sending API keys`.
+1. Copy the API key and add it to your `.env.server` file.
 
 ```properties title=".env.server"
 MAILGUN_API_KEY=
 MAILGUN_DOMAIN=
 ```
 
+#### Using the EU Region
+
+If your domain region is in the EU, you need to set the `MAILGUN_API_URL` variable in your `.env.server` file:
+
+```properties title=".env.server"
+MAILGUN_API_URL=https://api.eu.mailgun.net
+```
+
+
 ### Using the SendGrid Provider
 
 Set the provider field to `SendGrid` in your `main.wasp` file.