honojs-plugin-email

honojs-plugin-email

Email plugin for HonoJS. Supports two drivers:

• smtp — powered by Nodemailer
• resend — powered by Resend

Install

pnpm add honojs-plugin-email

Folder structure

src/
├── index.ts              # Smtp.create() factory + exports
├── nodemailer/
│   ├── index.ts           # Nodemailer wrapper class (initialize, send)
│   └── types.ts           # NodemailerParams type
└── schema/
    ├── index.ts           # EmailSchema (driver: 'smtp' | 'resend')
    ├── nodemailer.ts       # NodemailerSchema (MAIL_* env-shaped config)
    └── resend.ts           # ResendSchema (RESEND_* env-shaped config)

Usage

1. SMTP (Nodemailer)

import Smtp, { Nodemailer } from 'honojs-plugin-email'

const mailer = Smtp.create({
  driver: 'smtp',
  nodemailer: {
    driver: 'smtp',
    host: 'smtp.example.com',
    port: 587,
    from: 'no-reply@example.com',
    username: 'user@example.com',
    password: 'secret',
    encryption: 'tls',
  },
}) as Nodemailer

// verify connection (optional)
await mailer.initialize()

// send an email
await mailer.send({
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<p>Hello world</p>',
})

2. Resend

import Smtp, { Resend } from 'honojs-plugin-email'

const resend = Smtp.create({
  driver: 'resend',
  resend: {
    apiKey: process.env.RESEND_API_KEY,
    from: 'no-reply@example.com',
  },
}) as Resend

await resend.emails.send({
  from: 'no-reply@example.com',
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<p>Hello world</p>',
})

3. Using Nodemailer directly

import { Nodemailer } from 'honojs-plugin-email'

const mailer = new Nodemailer({
  transporter: {
    host: 'smtp.example.com',
    port: 587,
    secure: false,
    auth: { user: 'user@example.com', pass: 'secret' },
  },
  defaults: { from: 'no-reply@example.com' },
})

await mailer.send({ to: 'user@example.com', subject: 'Hi', text: 'Hello' })

Example: Hono route

import { Hono } from 'hono'
import Smtp, { Nodemailer } from 'honojs-plugin-email'

const app = new Hono()

const mailer = Smtp.create({
  driver: 'smtp',
  nodemailer: {
    host: process.env.MAIL_HOST,
    port: Number(process.env.MAIL_PORT),
    from: process.env.MAIL_FROM,
    username: process.env.MAIL_USERNAME,
    password: process.env.MAIL_PASSWORD,
  },
}) as Nodemailer

app.post('/contact', async (c) => {
  const body = await c.req.json()

  await mailer.send({
    to: body.email,
    subject: 'We received your message',
    text: 'Thank you for contacting us!',
  })

  return c.json({ success: true })
})

export default app

API

Smtp.create(config)

Param	Type	Description
config.driver	'smtp' | 'resend'	Which email driver to use
config.nodemailer	NodemailerConfig	Required when driver is 'smtp'
config.resend	ResendConfig	Required when driver is 'resend'

Returns a Nodemailer instance or the Resend client, depending on driver.

Nodemailer

Method	Description
initialize()	Verifies the SMTP transporter connection
send(options)	Sends an email via nodemailer.SendMailOptions