Add admin mailer.

README.md

@@ -271,6 +271,14 @@ 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. This let's you monitor your app and respond to users without watching the database.
+
+If you setup the admin emailer, it will email you when users create their profile or the 'Contact Us' form is submitted. You can add additional calls to sendAdminEmail() for any other events you want to monitor.
+
+To setup, 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. Then set the email address to which admin emails will be sent in `PRIVATE_ADMIN_EMAIL`.
+
 ## 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,15 @@
     "@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",
     "stripe": "^13.3.0"
+  },
+  "peerDependencies": {
+    "nodemailer": "^6.9.14"
+  },
+  "peerDependenciesMeta": {
+    "nodemailer": {
+      "optional": true
+    }
   }
 }

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,

src/routes/(marketing)/contact_us/+page.server.ts

@@ -1,4 +1,5 @@
 import { fail } from "@sveltejs/kit"
+import { sendAdminEmail } from "$lib/admin_mailer.js"
 
 /** @type {import('./$types').Actions} */
 export const actions = {
@@ -67,5 +68,11 @@ export const actions = {
     if (insertError) {
       return fail(500, { errors: { _: "Error saving" } })
     }
+
+    // Send email to admin
+    sendAdminEmail({
+      subject: "New contact request",
+      body: `New contact request from ${firstName} ${lastName}.\n\nEmail: ${email}\n\nPhone: ${phone}\n\nCompany: ${company}\n\nMessage: ${message}`,
+    })
   },
 }