Merge branch 'master' into feat/install-docker-pull

Author: ginkoid

server/email/index.js

@@ -0,0 +1,55 @@
+import path from 'path'
+import fs from 'fs'
+import mustache from 'mustache'
+import config from '../config/server'
+import { ProviderConstructor } from './provider'
+
+export type VerificationEmailKind = 'register' | 'recover' | 'update'
+
+let sendVerification: (data: {
+  token: string,
+  kind: VerificationEmailKind,
+  email: string
+}) => Promise<void> = async () => {
+  throw new Error('email verification requested when email provider is not configured')
+}
+
+const emailConfig = config.email
+if (emailConfig) {
+  const provider = (async () => {
+    const { default: Provider } = await import(path.join('../providers', emailConfig.provider.name)) as { default: ProviderConstructor }
+    return new Provider(emailConfig.provider.options ?? {})
+  })()
+
+  const verifyHtml = fs.readFileSync(path.join(__dirname, 'emails/verify.html')).toString()
+  const verifyText = fs.readFileSync(path.join(__dirname, 'emails/verify.txt')).toString()
+
+  // This function is already typed earlier in the file; no need to repeat the type definition
+  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+  sendVerification = async ({ token, kind, email }) => {
+    const emailView = {
+      ctf_name: config.ctfName,
+      logo_url: config.logoUrl,
+      origin: config.origin,
+      token: encodeURIComponent(token),
+      register: kind === 'register',
+      recover: kind === 'recover',
+      update: kind === 'update'
+    }
+    const subject = {
+      register: `Email verification for ${config.ctfName}`,
+      recover: `Account recovery for ${config.ctfName}`,
+      update: `Update your ${config.ctfName} email`
+    }[kind]
+
+    await (await provider).send({
+      from: `${config.ctfName} <${emailConfig.from}>`,
+      to: email,
+      subject,
+      html: mustache.render(verifyHtml, emailView),
+      text: mustache.render(verifyText, emailView)
+    })
+  }
+}
+
+export { sendVerification }

server/email/index.ts

@@ -9,3 +9,7 @@ export interface Mail {
 export interface Provider {
   send (options: Mail): Promise<void>;
 }
+
+export interface ProviderConstructor {
+  new (options: unknown): Provider
+}