feat: Create verifications module to streamline auth_email_* and auth_sms_*

Author: Blckbrry-Pi

modules/auth_email_password/db/migrations/1724526776_powerful_maverick.sql

@@ -18,7 +18,8 @@
     "users": {},
     "tokens": {},
     "user_passwords": {},
-    "rate_limit": {}
+    "rate_limit": {},
+    "verifications": {}
   },
   "defaultConfig": {
     "fromEmail": "hello@test.com",

modules/auth_email_password/db/migrations/meta/1724526776_snapshot.json

@@ -1,26 +1,28 @@
 import { ScriptContext } from "../module.gen.ts";
-import { createVerification } from "../utils/code_management.ts";
-import { Verification } from "../utils/types.ts";
 
 export interface Request {
 	email: string;
 	userToken?: string;
 }
 
 export interface Response {
-	verification: Verification;
+	token: string;
 }
 
+const HOUR_MS = 60 * 60 * 1000 * 1000;
+const ATTEMPTS = 3;
+
 export async function run(
 	ctx: ScriptContext,
 	req: Request,
 ): Promise<Response> {
 	await ctx.modules.rateLimit.throttlePublic({});
 
-	const { code, verification } = await createVerification(
-		ctx,
-		req.email,
-	);
+	const { code, token } = await ctx.modules.verifications.create({
+		data: { email: req.email },
+		expireAt: new Date(Date.now() + HOUR_MS).toISOString(),
+		maxAttempts: ATTEMPTS,
+	});
 
 	// Send email
 	await ctx.modules.email.sendEmail({
@@ -34,5 +36,5 @@ export async function run(
 		html: `Your verification code is: <b>${code}</b>`,
 	});
 
-	return { verification };
+	return { token };
 }

modules/auth_email_password/db/migrations/meta/_journal.json

@@ -1,5 +1,4 @@
 import { Empty, RuntimeError, ScriptContext } from "../module.gen.ts";
-import { verifyCode } from "../utils/code_management.ts";
 import { IDENTITY_INFO_PASSWORD } from "../utils/provider.ts";
 import { ensureNotAssociatedAll } from "../utils/link_assertions.ts";
 
@@ -10,7 +9,7 @@ export interface Request {
 	password: string;
 	oldPassword: string | null;
 
-	verificationToken: string;
+	token: string;
 	code: string;
 }
 
@@ -24,16 +23,25 @@ export async function run(
 
 	// Check the verification code. If it is valid, but for the wrong email, say
 	// the verification failed.
-	const { email } = await verifyCode(ctx, req.verificationToken, req.code);
-	if (!compareConstantTime(req.email, email)) {
+	const { data, succeeded } = await ctx.modules.verifications.attempt({ token: req.token, code: req.code });
+	if (!succeeded) throw new RuntimeError("invalid_code");
+
+	if (
+		typeof data !== "object" ||
+		data === null ||
+		!("email" in data) ||
+		typeof data.email !== "string"
+	) throw new RuntimeError("unknown_err");
+
+	if (!compareConstantTime(req.email, data.email)) {
 		throw new RuntimeError("verification_failed");
 	}
 
 	// Ensure that the email is not associated with ANY accounts in ANY way.
 	const providedUser = await ctx.modules.users.authenticateToken({
 		userToken: req.userToken,
 	});
-	await ensureNotAssociatedAll(ctx, email, new Set([providedUser.userId]));
+	await ensureNotAssociatedAll(ctx, data.email, new Set([providedUser.userId]));
 
 	// If an old password was provided, ensure it was correct and update it.
 	// If one was not, register the user with the `userPasswords` module.
@@ -58,7 +66,7 @@ export async function run(
 		userToken: req.userToken,
 		info: IDENTITY_INFO_PASSWORD,
 		uniqueData: {
-			identifier: email,
+			identifier: data.email,
 		},
 		additionalData: {},
 	});

modules/auth_email_password/db/schema.ts

@@ -1,13 +1,12 @@
 import { RuntimeError, ScriptContext } from "../module.gen.ts";
-import { verifyCode } from "../utils/code_management.ts";
 import { IDENTITY_INFO_PASSWORD } from "../utils/provider.ts";
 import { ensureNotAssociatedAll } from "../utils/link_assertions.ts";
 
 export interface Request {
 	email: string;
 	password: string;
 
-	verificationToken: string;
+	token: string;
 	code: string;
 }
 
@@ -23,19 +22,28 @@ export async function run(
 
 	// Check the verification code. If it is valid, but for the wrong email, say
 	// the verification failed.
-	const { email } = await verifyCode(ctx, req.verificationToken, req.code);
-	if (!compareConstantTime(req.email, email)) {
+	const { data, succeeded } = await ctx.modules.verifications.attempt({ token: req.token, code: req.code });
+	if (!succeeded) throw new RuntimeError("invalid_code");
+
+	if (
+		typeof data !== "object" ||
+		data === null ||
+		!("email" in data) ||
+		typeof data.email !== "string"
+	) throw new RuntimeError("unknown_err");
+
+	if (!compareConstantTime(req.email, data.email)) {
 		throw new RuntimeError("verification_failed");
 	}
 
 	// Ensure that the email is not associated with ANY accounts in ANY way.
-	await ensureNotAssociatedAll(ctx, email, new Set());
+	await ensureNotAssociatedAll(ctx, data.email, new Set());
 
 	// Sign up the user with the passwordless email identity
 	const { userToken, userId } = await ctx.modules.identities.signUp({
 		info: IDENTITY_INFO_PASSWORD,
 		uniqueData: {
-			identifier: email,
+			identifier: data.email,
 		},
 		additionalData: {},
 	});