@usequark/quark-create-app 1.25.16 → 1.27.0

package/templates/worker/src/handlers/email.js

@@ -5,6 +5,7 @@
 
 import { createEmailService } from "@usequark/quark-core/email";
 import {
+	emailVerificationEmail,
 	passwordResetEmail,
 	welcomeEmail,
 } from "@usequark/quark-core/email-templates";
@@ -13,6 +14,7 @@ import { JOB_NAMES } from "@usequark/quark-jobs";
 import {
 	requireResetPasswordEmailData,
 	requireUserEmailRecord,
+	requireVerifyEmailData,
 	requireWelcomeEmailUserId,
 } from "./email-job-validation.js";
 
@@ -94,5 +96,42 @@ export async function handleSendResetPasswordEmail(bullJob, logger) {
 	return { success: true, userId, email: userRecord.email };
 }
 
+/**
+ * Job handler for SEND_VERIFY_EMAIL
+ * @param {import("bullmq").Job} bullJob
+ * @param {import("@usequark/quark-core").Logger} logger
+ */
+export async function handleSendVerificationEmail(bullJob, logger) {
+	const { userId, verifyUrl } = requireVerifyEmailData(bullJob.data);
+
+	logger.info(`Sending email verification for user ${userId}`, {
+		job: JOB_NAMES.SEND_VERIFY_EMAIL,
+		userId,
+	});
+
+	const userRecord = requireUserEmailRecord(
+		userId,
+		await prisma.user.findUnique({
+			where: { id: userId },
+			select: { email: true, name: true },
+		}),
+	);
+
+	const template = emailVerificationEmail({
+		name: userRecord.name,
+		appName: process.env.APP_NAME,
+		verifyUrl,
+	});
+
+	await emailService.sendEmail(
+		userRecord.email,
+		template.subject,
+		template.html,
+		template.text,
+	);
+
+	return { success: true, userId, email: userRecord.email };
+}
+
 // Governance alerts are sent inline by the governance-check handler.
 // No standalone handler needed in Quark.

package/templates/worker/src/handlers/index.js

@@ -7,12 +7,14 @@
 import { JOB_NAMES } from "@usequark/quark-jobs";
 import {
 	handleSendResetPasswordEmail,
+	handleSendVerificationEmail,
 	handleSendWelcomeEmail,
 } from "./email.js";
 import { handleCleanupOrphanedFiles } from "./files.js";
 
 export const jobHandlers = {
 	[JOB_NAMES.SEND_WELCOME_EMAIL]: handleSendWelcomeEmail,
+	[JOB_NAMES.SEND_VERIFY_EMAIL]: handleSendVerificationEmail,
 	[JOB_NAMES.SEND_RESET_PASSWORD_EMAIL]: handleSendResetPasswordEmail,
 	[JOB_NAMES.CLEANUP_ORPHANED_FILES]: handleCleanupOrphanedFiles,
 };

package/templates/worker/src/readme-table.js

@@ -0,0 +1,68 @@
+/**
+ * Generates the README job-handler table.
+ *
+ * The row set is driven by JOB_NAMES (the jobs package is the source of truth
+ * for which jobs exist), never by the registry alone: generating from
+ * `jobHandlers` would produce a table that always matches what is registered
+ * and so could never expose a job name with no handler.
+ */
+
+import { AppError } from "@usequark/quark-core/errors";
+import { JOB_NAMES } from "@usequark/quark-jobs";
+
+/** Module under `src/handlers/` that defines each job's handler. */
+const HANDLER_MODULES = {
+	[JOB_NAMES.SEND_WELCOME_EMAIL]: "email.js",
+	[JOB_NAMES.SEND_VERIFY_EMAIL]: "email.js",
+	[JOB_NAMES.SEND_RESET_PASSWORD_EMAIL]: "email.js",
+	[JOB_NAMES.CLEANUP_ORPHANED_FILES]: "files.js",
+};
+
+export const TABLE_START = "<!-- handler-table:start -->";
+export const TABLE_END = "<!-- handler-table:end -->";
+
+/**
+ * Render the handler table for JOB_NAMES, one row per job name.
+ * @param {Record<string, Function>} jobHandlers
+ * @returns {string} markdown table (marker lines excluded)
+ */
+export function renderHandlerTable(jobHandlers) {
+	const rows = Object.values(JOB_NAMES).map((jobName) => {
+		const handler = jobHandlers[jobName];
+		const module = HANDLER_MODULES[jobName];
+		if (typeof handler !== "function" || !module) {
+			throw new AppError(
+				`No handler registration or README metadata for job: ${jobName}`,
+				500,
+				"JOB_README_ROW_MISSING",
+			);
+		}
+		return `| \`${jobName}\` | \`${handler.name}\` (\`handlers/${module}\`) |`;
+	});
+	return ["| Job name | Handler |", "|---|---|", ...rows].join("\n");
+}
+
+/**
+ * Replace the marked table block in a README with the generated one.
+ * @param {string} markdown
+ * @param {Record<string, Function>} jobHandlers
+ * @returns {string} updated markdown
+ */
+export function replaceHandlerTable(markdown, jobHandlers) {
+	const start = markdown.indexOf(TABLE_START);
+	const end = markdown.indexOf(TABLE_END);
+	if (start === -1 || end === -1 || end < start) {
+		throw new AppError(
+			"README is missing handler-table markers",
+			500,
+			"JOB_README_MARKERS_MISSING",
+		);
+	}
+	return (
+		markdown.slice(0, start + TABLE_START.length) +
+		"\n" +
+		renderHandlerTable(jobHandlers) +
+		"\n" +
+		markdown.slice(end)
+	);
+}