@cocalc/server/email/sendgrid.ts

CoCalc server functionality: functions used by either the hub and the next.js server

/* We use the official V3 Sendgrid API:

https://www.npmjs.com/package/@sendgrid/mail

The cocalc ASM group numbers are at

https://app.sendgrid.com/suppressions/advanced_suppression_manager
*/

import getPool from "@cocalc/database/pool";
import sgMail from "@sendgrid/mail";
import type { Message } from "./message";
import getHelpEmail from "./help";
import appendFooter from "./footer";
import { SENDGRID_TEMPLATE_ID } from "@cocalc/util/theme";

// Init throws error if we can't initialize Sendgrid right now.
// It also updates the key if it changes in at most one minute (?).
let initialized = 0;
export async function getSendgrid(): Promise<any> {
  const now = new Date().valueOf();
  if (now - initialized < 1000 * 30) {
    // initialized recently
    return sgMail;
  }
  const pool = getPool("long");
  const { rows } = await pool.query(
    "SELECT value FROM server_settings WHERE name='sendgrid_key'"
  );
  if (rows.length == 0 || !rows[0]?.value) {
    if (initialized) {
      // no key now, but there was a key before -- so clear it and error
      sgMail.setApiKey("");
    }
    throw Error("no sendgrid key");
  }
  sgMail.setApiKey(rows[0].value);
  initialized = new Date().valueOf();
  return sgMail;
}

export default async function sendEmail(message: Message): Promise<void> {
  const sg = await getSendgrid();
  const msg: any = await appendFooter(message);
  if (!msg.from) {
    msg.from = await getHelpEmail(); // fallback
  }
  if (msg.asm_group) {
    msg.asm = { group_id: msg.asm_group };
    delete msg.asm_group;
  }
  // plain template with a header (cocalc logo), a h1 title, and a footer
  msg.template_id = SENDGRID_TEMPLATE_ID;

  // https://docs.sendgrid.com/api-reference/mail-send/mail-send
  await sg.send(msg);
}