Export is PDF, RULE.md, and Print on US Letter, with every shared term, no member names, and a takeaway that points at Ask an organizer. Finished Rules keep type and place so the team can read folded counts without a database, Umami can sit beside the app with no cookies, and the person who holds the pen gets working PDF and RULE.md links 48 hours later.
208 lines
6.0 KiB
TypeScript
208 lines
6.0 KiB
TypeScript
import nodemailer from "nodemailer";
|
|
import { logger } from "../logger";
|
|
import {
|
|
buildWorkshopConfirmationMail,
|
|
buildWorkshopInboxMail,
|
|
type WorkshopInquiryMailInput,
|
|
} from "../workshopSignupMail";
|
|
import { MAGIC_LINK_TTL_MINUTES } from "../privacyRetention";
|
|
import { getSmtpUrl } from "./env";
|
|
import {
|
|
buildRuleStakeholderInviteMail,
|
|
stakeholderInviteReplyTo,
|
|
type RuleStakeholderInviteMailInput,
|
|
} from "./ruleStakeholderInviteMail";
|
|
import {
|
|
buildRuleFollowUpMail,
|
|
type RuleFollowUpMailInput,
|
|
} from "./ruleFollowUpMail";
|
|
|
|
function escapeHtml(value: string): string {
|
|
return value
|
|
.replace(/&/g, "&")
|
|
.replace(/</g, "<")
|
|
.replace(/>/g, ">")
|
|
.replace(/"/g, """);
|
|
}
|
|
|
|
export function resolveMailFrom(): string {
|
|
return (
|
|
process.env.SMTP_FROM?.trim() ||
|
|
process.env.CLOUDRON_MAIL_FROM?.trim() ||
|
|
"noreply@localhost"
|
|
);
|
|
}
|
|
|
|
/** Avoid quoted-printable `token=3D` wrapping that some webmail clients do not decode. */
|
|
export const MAIL_TEXT_ENCODING = "base64" as const;
|
|
|
|
/** Plaintext + HTML for one-time verify URLs. */
|
|
export function buildVerifyLinkParts(
|
|
verifyUrl: string,
|
|
intro: string,
|
|
outro: string,
|
|
linkLabel: string,
|
|
): { text: string; html: string } {
|
|
const href = escapeHtml(verifyUrl);
|
|
const text = `${intro}\n\n<${verifyUrl}>\n\n${outro}`;
|
|
const html =
|
|
`<p>${escapeHtml(intro).replace(/\n/g, "<br />")}</p>` +
|
|
`<p><a href="${href}">${escapeHtml(linkLabel)}</a></p>` +
|
|
`<p><a href="${href}">${href}</a></p>` +
|
|
`<p>${escapeHtml(outro)}</p>`;
|
|
return { text, html };
|
|
}
|
|
|
|
async function sendHtmlMail(opts: {
|
|
to: string;
|
|
subject: string;
|
|
text: string;
|
|
html: string;
|
|
from?: string;
|
|
replyTo?: string;
|
|
devLog: string;
|
|
}): Promise<void> {
|
|
const smtpUrl = getSmtpUrl();
|
|
|
|
if (!smtpUrl) {
|
|
if (process.env.NODE_ENV === "development") {
|
|
logger.info(opts.devLog);
|
|
return;
|
|
}
|
|
throw new Error("CLOUDRON_MAIL_SMTP_* is not configured");
|
|
}
|
|
|
|
const transporter = nodemailer.createTransport(smtpUrl);
|
|
await transporter.sendMail({
|
|
from: opts.from ?? resolveMailFrom(),
|
|
to: opts.to,
|
|
subject: opts.subject,
|
|
text: opts.text,
|
|
html: opts.html,
|
|
textEncoding: MAIL_TEXT_ENCODING,
|
|
replyTo: opts.replyTo,
|
|
});
|
|
}
|
|
|
|
export async function sendMagicLinkEmail(
|
|
to: string,
|
|
verifyUrl: string,
|
|
): Promise<void> {
|
|
const { text, html } = buildVerifyLinkParts(
|
|
verifyUrl,
|
|
`Open this link to log in (it expires in ${MAGIC_LINK_TTL_MINUTES} minutes):`,
|
|
"If you did not request this, you can ignore this email.\n\nSent because you saved a draft at communityrule.info",
|
|
"Log in",
|
|
);
|
|
await sendHtmlMail({
|
|
to,
|
|
subject: "Log in to Community Rule",
|
|
text,
|
|
html,
|
|
devLog: `[dev] Magic link for ${to}: ${verifyUrl}`,
|
|
});
|
|
}
|
|
|
|
/** Stakeholder invite after finishing a Rule (one-time link, same Mailhog pattern as magic link). */
|
|
export async function sendRuleStakeholderInviteEmail(
|
|
input: RuleStakeholderInviteMailInput,
|
|
): Promise<void> {
|
|
const { subject, text, html } = buildRuleStakeholderInviteMail(input);
|
|
const replyTo = stakeholderInviteReplyTo(input.inviterEmail);
|
|
await sendHtmlMail({
|
|
to: input.to,
|
|
subject,
|
|
text,
|
|
html,
|
|
...(replyTo ? { replyTo } : {}),
|
|
devLog: `[dev] Rule stakeholder invite (${input.communityName}) for ${input.to}: ${input.verifyUrl}`,
|
|
});
|
|
}
|
|
|
|
/** 48-hour print follow-up to the address that holds the pen. */
|
|
export async function sendRuleFollowUpEmail(
|
|
input: RuleFollowUpMailInput,
|
|
): Promise<void> {
|
|
const { subject, text, html } = buildRuleFollowUpMail(input);
|
|
await sendHtmlMail({
|
|
to: input.to,
|
|
subject,
|
|
text,
|
|
html,
|
|
devLog: `[dev] Rule follow-up mail for ${input.to}`,
|
|
});
|
|
}
|
|
|
|
/** Notify support/organizers when a visitor submits the Ask an organizer form. */
|
|
export async function sendOrganizerInquiryNotification(params: {
|
|
/** Destination inbox (e.g. from ORGANIZER_INQUIRY_TO). */
|
|
to: string;
|
|
fromEmail: string;
|
|
visitorEmail: string;
|
|
message: string;
|
|
requestId: string;
|
|
}): Promise<void> {
|
|
const { to, fromEmail, visitorEmail, message, requestId } = params;
|
|
const text = `Request ID: ${requestId}\nFrom: ${visitorEmail}\n\n${message}\n`;
|
|
const html =
|
|
`<p>Request ID: ${escapeHtml(requestId)}<br />From: ${escapeHtml(visitorEmail)}</p>` +
|
|
`<pre>${escapeHtml(message)}</pre>`;
|
|
await sendHtmlMail({
|
|
to,
|
|
from: fromEmail,
|
|
replyTo: visitorEmail,
|
|
subject: `Ask an organizer inquiry from ${visitorEmail}`,
|
|
text,
|
|
html,
|
|
devLog: `[dev] Organizer inquiry (request ${requestId}) from ${visitorEmail} to ${to}:\n${message}`,
|
|
});
|
|
}
|
|
|
|
export async function sendWorkshopInquiryNotification(
|
|
input: WorkshopInquiryMailInput & { to: string },
|
|
): Promise<void> {
|
|
const { subject, text, html } = buildWorkshopInboxMail(input);
|
|
await sendHtmlMail({
|
|
to: input.to,
|
|
replyTo: input.values.email,
|
|
subject,
|
|
text,
|
|
html,
|
|
devLog: `[dev] Workshop inquiry ${input.requestId} from ${input.values.email} to ${input.to}:\n${text}`,
|
|
});
|
|
}
|
|
|
|
export async function sendWorkshopInquiryConfirmation(input: {
|
|
to: string;
|
|
largeOrganization: boolean;
|
|
schedulingUrl: string;
|
|
}): Promise<void> {
|
|
const { subject, text, html } = buildWorkshopConfirmationMail(input);
|
|
await sendHtmlMail({
|
|
to: input.to,
|
|
subject,
|
|
text,
|
|
html,
|
|
devLog: `[dev] Workshop confirmation for ${input.to} (large=${input.largeOrganization})`,
|
|
});
|
|
}
|
|
|
|
export async function sendEmailChangeEmail(
|
|
to: string,
|
|
verifyUrl: string,
|
|
): Promise<void> {
|
|
const { text, html } = buildVerifyLinkParts(
|
|
verifyUrl,
|
|
`You asked to change the email on your Community Rule account.\n\nOpen this link to confirm the new address (it expires in ${MAGIC_LINK_TTL_MINUTES} minutes):`,
|
|
"If you did not request this change, you can ignore this email. Your current login is unchanged until you confirm.",
|
|
"Confirm email",
|
|
);
|
|
await sendHtmlMail({
|
|
to,
|
|
subject: "Confirm your new Community Rule email",
|
|
text,
|
|
html,
|
|
devLog: `[dev] Email change verify for ${to}: ${verifyUrl}`,
|
|
});
|
|
}
|