From fa19b9ad1e58ef4d1e830de8f9803fbd0a7eee3f Mon Sep 17 00:00:00 2001
From: DebaucheryLibrarian <DebaucheryLibrarian@unknown.name>
Date: Thu, 12 Nov 2026 21:26:19 +0100
Subject: [PATCH] Added e-mail test button.

---
 pages/admin/emails/@template/+Page.vue | 60 +++++++++++++++++++++++++-
 src/email.js                           | 31 +++++++++++++
 src/web/server.js                      |  2 +
 3 files changed, 91 insertions(+), 2 deletions(-)

diff --git a/pages/admin/emails/@template/+Page.vue b/pages/admin/emails/@template/+Page.vue
index dd7a340..e1a7f23 100644
--- a/pages/admin/emails/@template/+Page.vue
+++ b/pages/admin/emails/@template/+Page.vue
@@ -1,9 +1,10 @@
 <script setup>
-import { inject } from 'vue';
+import { inject, ref } from 'vue';
 
 import Admin from '#/components/admin/admin.vue';
+import { post } from '#/src/api.js';
 
-const { pageProps } = inject('pageContext');
+const { pageProps, user } = inject('pageContext');
 
 const {
 	template,
@@ -11,12 +12,55 @@ const {
 	text,
 	error,
 } = pageProps;
+
+const testAddress = ref(user?.email || '');
+const sending = ref(false);
+
+async function sendTest() {
+	const to = testAddress.value.trim();
+
+	sending.value = true;
+
+	try {
+		await post(`/admin/emails/${encodeURIComponent(template)}/test`, { to }, {
+			successFeedback: `Sent test e-mail to ${to}`,
+			errorFeedback: 'Failed to send test e-mail',
+			appendErrorMessage: true,
+		});
+	}
+	catch (_error) {
+		// feedback is shown by the api module
+	}
+	finally {
+		sending.value = false;
+	}
+}
 </script>
 
 <template>
 	<Admin class="page">
 		<div class="header">
 			<h2 class="heading">{{ template }}</h2>
+
+			<form
+				v-if="!error"
+				class="test"
+				@submit.prevent="sendTest"
+			>
+				<input
+					v-model="testAddress"
+					type="email"
+					class="input"
+					placeholder="E-mail address"
+					required
+				>
+
+				<button
+					type="submit"
+					class="button button-primary"
+					:disabled="sending"
+				>{{ sending ? 'Sending...' : 'Send test' }}</button>
+			</form>
 		</div>
 
 		<p v-if="error" class="error">Failed to render template: {{ error }}</p>
@@ -39,11 +83,23 @@ const {
 <style scoped>
 .header {
 	display: flex;
+	flex-wrap: wrap;
 	align-items: baseline;
 	gap: 1rem;
 	margin-bottom: 1rem;
 }
 
+.test {
+	display: flex;
+	align-items: stretch;
+	gap: .5rem;
+	margin-left: auto;
+
+	.input {
+		width: 18rem;
+	}
+}
+
 .error {
 	color: var(--warn);
 	font-weight: bold;
diff --git a/src/email.js b/src/email.js
index 041d21a..41dc5be 100644
--- a/src/email.js
+++ b/src/email.js
@@ -2,6 +2,7 @@ import config from 'config';
 import { Resend } from 'resend';
 
 import { emailTemplates } from './email-templates.js';
+import { HttpError } from './errors.js';
 import initLogger from './logger.js';
 
 const logger = initLogger();
@@ -82,3 +83,33 @@ export async function sendEmails(items) {
 
 	return data;
 }
+
+// sends a template the way the admin preview displays it, rendered with the template's own mock props
+export async function sendTestEmail(template, to) {
+	if (!config.email.enabled) {
+		throw new HttpError('E-mails are disabled', 503);
+	}
+
+	if (!resend) {
+		throw new HttpError('E-mails are enabled, but Resend is not initialized', 503);
+	}
+
+	const { html, text } = await emailTemplates.render(`${template}.vue`);
+
+	const { data, error } = await resend.emails.send({
+		from: config.email.from,
+		to,
+		subject: `Test: ${template}`,
+		html,
+		text,
+	});
+
+	if (error) {
+		logger.error(`Failed to send '${template}' test e-mail to '${to}' (${error.statusCode} ${error.name}): ${error.message}`);
+		throw new HttpError(`Failed to send test e-mail: ${error.message}`, 502);
+	}
+
+	logger.info(`Sent '${template}' test e-mail to '${to}'`);
+
+	return data;
+}
diff --git a/src/web/server.js b/src/web/server.js
index 32fda6a..747a775 100644
--- a/src/web/server.js
+++ b/src/web/server.js
@@ -19,6 +19,7 @@ import { authRouter, setUserApi } from './auth.js';
 
 import consentHandler from './consent.js';
 
+import { sendTestEmailApi } from './emails.js';
 import { fetchEntitiesApi } from './entities.js';
 import errorHandler from './error.js';
 import { graphqlApi } from './graphql.js';
@@ -143,6 +144,7 @@ export default async function initServer() {
 	router.get('/api/tags', fetchTagsApi);
 
 	router.post('/api/caches', initCachesApi);
+	router.post('/api/admin/emails/:template/test', sendTestEmailApi);
 
 	if (config.apiAccess.graphqlEnabled) {
 		router.post('/graphql', graphqlApi);