Add admin mailer.

README.md

@@ -271,6 +271,16 @@ If you prefer another host you can explore alternatives:
 - [Community adapters](https://sveltesociety.dev/components#adapters) including Github pages, AppEngine, Azure, and more
 - [Supabase](https://supabase.com/docs/guides/getting-started/quickstarts/sveltekit) if you want one host for everything. Note: they do charge $10 a month for custom domains, unlike Cloudflare.
 
+## Setup Admin Emailer -- Optional
+
+SaaS Starter includes an admin emailer for sending yourself email notifications when important events happen, such as a new user creating their profile. This let's you monitor your app and respond to users without watching the database.
+
+Provide email SMTP credientials in your environment variables: `PRIVATE_SMTP_HOST`, `PRIVATE_SMTP_PORT`, `PRIVATE_SMTP_USER`, `PRIVATE_SMTP_PASS`. You can use any SMTP providers such as Gmail, Sendgrid, AWS SES, Resend, or Mailgun.
+
+Set the email address which admil emails will be sent to in `PRIVATE_ADMIN_EMAIL`.
+
+You can add additional calls to sendAdminEmail() for any other events you want to monitor.
+
 ## Add Your Content
 
 After the steps above, you’ll have a working version like the demo page. However, it’s not branded, and doesn’t have your content. The following checklist helps you customize the template to make a SaaS homepage for your company.

local_env_template

@@ -1,4 +1,14 @@
+# Supabase settings
 PUBLIC_SUPABASE_URL='https://REPLACE_ME.supabase.co'
 PUBLIC_SUPABASE_ANON_KEY='REPLACE_ME'
 PRIVATE_SUPABASE_SERVICE_ROLE='REPLACE_ME'
+
+# Stripe settings
 PRIVATE_STRIPE_API_KEY='REPLACE_ME'
+
+# SMTP settings for email - optional
+# PRIVATE_ADMIN_EMAIL='[email protected]' # see lib/admin_mailer.ts
+# PRIVATE_SMTP_HOST='REPLACE_ME'
+# PRIVATE_SMTP_PORT='587'
+# PRIVATE_SMTP_USER='REPLACE_ME'
+# PRIVATE_SMTP_PASS='REPLACE_ME'

package.json

@@ -41,6 +41,8 @@
     "@supabase/auth-helpers-sveltekit": "^0.11.0",
     "@supabase/auth-ui-svelte": "^0.2.9",
     "@supabase/supabase-js": "^2.33.0",
+    "@types/nodemailer": "^6.4.15",
+    "nodemailer": "^6.9.14",
     "stripe": "^13.3.0"
   }
 }

src/lib/admin_mailer.ts

@@ -0,0 +1,62 @@
+import nodemailer from "nodemailer"
+
+import { env } from "$env/dynamic/private"
+
+// Sends an email to the admin email address.
+// Does not throw errors, but logs them.
+export const sendAdminEmail = async ({
+  subject,
+  body,
+}: {
+  subject: string
+  body: string
+}) => {
+  // Check admin email is set.
+  if (!env.PRIVATE_ADMIN_EMAIL) {
+    return
+  }
+
+  // Check if smtp settings are set.
+  if (
+    !env.PRIVATE_SMTP_HOST ||
+    !env.PRIVATE_SMTP_USER ||
+    !env.PRIVATE_SMTP_PASS
+  ) {
+    console.log(
+      "No smtp settings, not sending admil email. See CMSaasStarter setup instructions.",
+    )
+    return
+  }
+
+  // Default to port 587 if not set.
+  let port = 587
+  if (env.PRIVATE_SMTP_PORT) {
+    port = parseInt(env.PRIVATE_SMTP_PORT)
+  }
+
+  try {
+    const transporter = nodemailer.createTransport({
+      host: env.PRIVATE_SMTP_HOST,
+      port: port,
+      secure: port === 465, // https://nodemailer.com/smtp/
+      requireTLS: true, // Email should be encrypted in 2024
+      auth: {
+        user: env.PRIVATE_SMTP_USER,
+        pass: env.PRIVATE_SMTP_PASS,
+      },
+    })
+
+    const info = await transporter.sendMail({
+      from: env.PRIVATE_ADMIN_EMAIL,
+      to: env.PRIVATE_ADMIN_EMAIL,
+      subject: "ADMIN_MAIL: " + subject,
+      text: body,
+    })
+
+    if (info.rejected && info.rejected.length > 0) {
+      console.log("Failed to send admin email, rejected:", info.rejected)
+    }
+  } catch (e) {
+    console.log("Failed to send admin email, error:", e)
+  }
+}

src/routes/(admin)/account/api/+page.server.ts

@@ -1,4 +1,5 @@
 import { fail, redirect } from "@sveltejs/kit"
+import { sendAdminEmail } from "$lib/admin_mailer"
 
 export const actions = {
   updateEmail: async ({ request, locals: { supabase, safeGetSession } }) => {
@@ -255,6 +256,11 @@ export const actions = {
       })
     }
 
+    sendAdminEmail({
+      subject: "Profile Updated",
+      body: `Profile updated by ${session.user.email}\nFull name: ${fullName}\nCompany name: ${companyName}\nWebsite: ${website}`,
+    })
+
     return {
       fullName,
       companyName,