Send email from Claude Code

Add transactional email to this project using emails.sh.

Read https://emails.sh/docs.md first so you use the real request shape instead of guessing it. https://emails.sh/llms.txt lists the rest of the pages if you need a framework guide for this stack.

1. Run `npm install @emails.sh/sdk` (or `pip install emailssh` if this is a Python project).
2. Put EMAILSSH_API_KEY in the env file this project already uses, and confirm that file is gitignored. If no key exists, stop and tell me to create one at https://emails.sh/dashboard rather than inventing a placeholder that looks real.
3. Add one server-side module that reads the key from the environment and exposes a send function. Do not scatter the key across files and do not commit it.
4. Call that function from the signup handler to send a verification email, from onboarding@emails.sh until my own domain is verified.
5. Show me the diff and tell me how to test it once, without sending to real users.

import { Emailssh } from '@emails.sh/sdk';
import { NextResponse } from 'next/server';

const emails = new Emailssh(process.env.EMAILSSH_API_KEY!);

export async function POST(request: Request) {
	const { email } = await request.json();

	// Your own code: create the account and mint a single-use token.
	const token = crypto.randomUUID();
	const link = `https://acme.com/verify?token=${token}`;

	const { id, status } = await emails.send({
		from: 'Acme <hello@acme.com>',
		to: [email],
		subject: 'Confirm your email',
		html: `<p>Welcome to Acme.</p><p><a href="${link}">Confirm your email</a></p>`,
		text: `Welcome to Acme. Confirm your email: ${link}`,
		// Tags show up in the dashboard, so you can filter every verification
		// send when someone reports that signup mail is not arriving.
		tags: { type: 'verification' },
		idempotencyKey: `verify:${token}`
	});

	// status is "queued" here. Delivery events arrive later, and GET
	// /v1/emails/${id} is what tells you whether it landed.
	return NextResponse.json({ emailId: id, status });
}

To:      you@example.com
Subject: Confirm your email

Welcome to Acme. Confirm your email: https://acme.com/verify?token=6d0b93