email-notifications

Email Notifications

Build production-ready email systems with proper deliverability, bounce handling, and template management.

Core Integration Patterns

SendGrid Setup

// BAD: API key in code, no error handling
import sgMail from '@sendgrid/mail';
sgMail.setApiKey('SG.abc123...');
await sgMail.send({
  to: user.email,
  from: '[email protected]',
  subject: 'Welcome',
  html: '<h1>Welcome!</h1>'
});

// GOOD: Environment-based config, typed responses
import sgMail from '@sendgrid/mail';
import { z } from 'zod';

const EmailConfig = z.object({
  apiKey: z.string().min(1),
  fromEmail: z.string().email(),
  fromName: z.string(),
  replyTo: z.string().email().optional(),
});

class SendGridClient {
  constructor(private config: z.infer<typeof EmailConfig>) {
    sgMail.setApiKey(config.apiKey);
  }

  async send(params: {
    to: string;
    subject: string;
    html: string;
    text?: string;
    category?: string;
  }): Promise<{ messageId: string }> {
    const msg = {
      to: params.to,
      from: {
        email: this.config.fromEmail,
        name: this.config.fromName,
      },
      replyTo: this.config.replyTo,
      subject: params.subject,
      html: params.html,
      text: params.text || this.stripHtml(params.html),
      categories: params.category ? [params.category] : undefined,
      trackingSettings: {
        clickTracking: { enable: true },
        openTracking: { enable: true },
      },
    };

    const [response] = await sgMail.send(msg);
    return { messageId: response.headers['x-message-id'] };
  }

  private stripHtml(html: string): string {
    return html.replace(/<[^>]*>/g, '').trim();
  }
}

AWS SES Setup

// BAD: No credential management, missing deliverability headers
import { SES } from '@aws-sdk/client-ses';
const ses = new SES({});
await ses.sendEmail({
  Source: '[email protected]',
  Destination: { ToAddresses: [email] },
  Message: {
    Subject: { Data: subject },
    Body: { Html: { Data: html } }
  }
});