Seeking Feedback: I built senderwolf to fix my Node.js email headaches. Is the API clean enough?

#javascript #node #webdev #opensource

As a developer working on Audit Systems and internal tools, I’ve always found existing Node.js email libraries a bit... heavy. I wanted something that felt modern, was natively built with TypeScript, and could handle bulk sending without me manually managing connection pools.

So, I built Senderwolf.

It’s now at v3.5.0, and I’m at the point where I need "outsider" eyes to tell me where it breaks or how the DX (Developer Experience) could be better.

What I’m trying to solve

The goal was to create a library that is *50-80% faster * for bulk emails by using built-in connection pooling and zero-config provider detection.

The "Clean API" Test

I’m really focused on the API design. Does this look intuitive to you?

import { sendEmail } from "senderwolf";

await sendEmail({
    smtp: {
        auth: { user: "your@outlook.com", pass: "password" }, // Auto-detects settings for 13+ providers
    },
    mail: {
        to: "recipient@example.com",
        subject: "Weekly Report",
        html: ""<h1>Here is your data</h1>"",
    },
});

Specific Feedback I'm Looking For

I would love for the DEV community to tear this apart (constructively!):

The Error System: I implemented custom error classes like AuthenticationError and SMTPError. Does this help your workflow, or is it overkill?
DKIM Implementation: I added RFC 6376-compliant signing using only Node's native cryptomodule (zero extra dependencies). Does it work with your specific DNS setup?
The CLI Tool: There is a built-in CLI for previewing templates (senderwolf-templates preview). Is a CLI useful for your email workflow, or do you prefer doing everything in code?
Auto-Text Fallback: It automatically generates plain-text from HTML. Have you noticed any weird formatting issues with the conversion?

How it stacks up

According to my benchmarks, Senderwolf currently leads in Setup Complexity and Dynamic Credentials compared to the "big players".

Try it & Roast it

If you have 5 minutes, please try installing it and let me know the first thing that annoys you.

DEV Community