feat(providers): Mailgun region selection (#13027)

Fix(provider): Mailgun region server

Co-authored-by: Thang Vu <[email protected]>

Author: benhovinga

docs/pages/getting-started/providers/mailgun.mdx

@@ -41,6 +41,8 @@ AUTH_MAILGUN_KEY=abc
 
 If you name your environment variable `AUTH_MAILGUN_KEY`, the provider will pick it up automatically and your Auth.js configuration object can be simpler. If you'd like to rename it to something else, however, you'll have to manually pass it into the provider in your Auth.js configuration.
 
+3. If you are using the EU Mailgun server, you will need to include `region: "EU"` in the provider options. If you are using the US Mailgun server you can remove this option.
+
 <Code>
 <Code.Next>
 
@@ -53,8 +55,9 @@ export const { handlers, auth, signIn, signOut } = NextAuth({
   providers: [
     Mailgun({
       // If your environment variable is named differently than default
-      apiKey: import.meta.env.AUTH_MAILGUN_KEY,
-      from: "[email protected]"
+      apiKey: process.env.AUTH_MAILGUN_KEY,
+      from: "[email protected]",
+      region: "EU",  // Optional
     }),
   ],
 })
@@ -74,6 +77,7 @@ export const { onRequest, useSession, useSignIn, useSignOut } = QwikAuth$(
         // If your environment variable is named differently than default
         apiKey: import.meta.env.AUTH_MAILGUN_KEY,
         from: "[email protected]",
+        region: "EU", // Optional
       }),
     ],
   })
@@ -95,6 +99,7 @@ export const { handle, signIn, signOut } = SvelteKitAuth({
       // If your environment variable is named differently than default
       apiKey: env.AUTH_MAILGUN_KEY,
       from: "[email protected]",
+      region: "EU",  // Optional
     }),
   ],
 })

packages/core/src/providers/mailgun.ts

@@ -24,7 +24,10 @@ import { html, text } from "../lib/utils/email.js"
  * const request = new Request(origin)
  * const response = await Auth(request, {
  *   providers: [
- *     Mailgun({ from: MAILGUN_DOMAIN }),
+ *     Mailgun({
+ *       from: MAILGUN_DOMAIN,
+ *       region: "EU", // Optional
+ *     }),
  *   ],
  * })
  * ```
@@ -43,7 +46,23 @@ import { html, text } from "../lib/utils/email.js"
  *
  * :::
  */
-export default function MailGun(config: EmailUserConfig): EmailConfig {
+export default function MailGun(
+  config: EmailUserConfig & {
+    /**
+     * https://documentation.mailgun.com/docs/mailgun/api-reference/#base-url
+     *
+     * @default "US"
+     */
+    region?: "US" | "EU"
+  }
+): EmailConfig {
+  const { region = "US" } = config
+  const servers = {
+    US: "api.mailgun.net",
+    EU: "api.eu.mailgun.net",
+  }
+  const apiServer = servers[region]
+
   return {
     id: "mailgun",
     type: "email",
@@ -64,7 +83,7 @@ export default function MailGun(config: EmailUserConfig): EmailConfig {
       form.append("html", html({ host, url, theme }))
       form.append("text", text({ host, url }))
 
-      const res = await fetch(`https://api.mailgun.net/v3/${domain}/messages`, {
+      const res = await fetch(`https://${apiServer}/v3/${domain}/messages`, {
         method: "POST",
         headers: {
           Authorization: `Basic ${btoa(`api:${provider.apiKey}`)}`,