v1.1 tracking — deliverability, compliance, ergonomics

[productdevbook]

Umbrella tracking issue for the v1.1 cycle. Sourced from 3 research streams: competitor audit (nodemailer, Resend, SendGrid, Postmark, Mailgun, SES, Upyo, …), developer pain-point research (GitHub issues, Stack Overflow, edge runtime forums), and internal gap audit.

Critical (blocks credible "production email" positioning)

• Auto-inject List-Unsubscribe + RFC 8058 one-click headers #57 — List-Unsubscribe + RFC 8058 one-click (Gmail/Yahoo Feb 2024)
• DKIM signing inside SMTP driver (RSA + Ed25519, Web-Crypto) #58 — DKIM signing in SMTP driver (RSA + Ed25519)
• Suppression list primitive (bounce + complaint + unsubscribe store) #59 — Suppression list primitive
• Template variables pass-through across provider drivers #60 — Template variables pass-through across 8 drivers
• Queue worker should respect scheduledAt (deferred sends) #61 — Queue worker respects `scheduledAt`

High (strong leverage, closes incumbent parity)

• OAuth2 refresh middleware (Gmail, Microsoft 365 presets) #62 — OAuth2 refresh middleware (Gmail/MS presets)
• SendGrid-style personalizations (per-recipient substitutions + batch) #63 — SendGrid-style personalizations
• ICS calendar invite builder (icalEvent parity) #64 — ICS calendar invite builder
• Driver lifecycle: cancel(id) and retrieve(id) (Resend parity) #65 — driver.cancel(id) + driver.retrieve(id)
• Per-message tracking + sandbox mode + custom args #66 — Per-message tracking + sandbox + custom args
• Typed getInstance() and provider-SDK branded returns #67 — Typed getInstance() / provider-SDK branded returns
• Reply stripper + thread stitcher for inbound #68 — Reply stripper + thread stitcher
• DMARC aggregate (RUA) report parser #69 — DMARC aggregate (RUA) parser
• Unified event stream (send.queued → delivered → opened → bounced) #70 — Unified event stream
• Standard Webhooks (standardwebhooks.com) reference verifier #71 — Standard Webhooks reference verifier
• Per-package tree-shake split: @unemail/resend, @unemail/ses, @unemail/smtp #72 — RFC: per-package tree-shake split (v1.2 candidate)
• Preheader text + inline-CSS (juice) + dark-mode hooks for HTML pipeline #73 — Preheader + juice + dark-mode HTML pipeline
• More test matchers + snapshot + recipient-address helpers #74 — Test matchers + snapshot helpers
• Provider-aware rate-limit middleware (proactive Retry-After bucketing) #75 — Provider-aware rate-limit (per-driver buckets)

Medium (valuable when time allows)

• Multi-region driver presets (Mailgun EU vs US, etc.) #76 — Multi-region driver presets (Mailgun EU, etc.)
• BullMQ + pg-boss + SQS queue adapters #77 — BullMQ / pg-boss / SQS queue adapters
• ARC signer (Authenticated Received Chain) for intermediaries #78 — ARC signer
• MTA-STS / TLS-RPT policy generator + ingester #79 — MTA-STS / TLS-RPT generator + parser
• Feedback loop (FBL / ARF) report parser #80 — FBL / ARF parser
• Typed Address primitive with RFC 5322 + SMTPUTF8 validation #81 — Typed Address primitive
• Dedup + idempotency middleware (content-hash guard) #82 — Dedupe middleware
• Retry jitter variants + dead-letter routing #83 — Retry jitter variants + dead-letter
• Preferences store + category-based opt-out (preference center) #84 — Preferences store (preference center)
• SES inbound adapter via SNS #85 — SES inbound via SNS
• Prometheus / OTLP metrics emitter middleware #86 — Prometheus / OTLP metrics
• Handlebars / Liquid / i18n template adapters #87 — Handlebars / Liquid / i18n
• Result<T> helpers: unwrap, isOk, isErr, tryAsync #88 — Result helpers
• Async iterator for sendBatch streaming #89 — Async iterator sendBatch
• PII scrubber middleware (body + attachments + recipient redaction) #90 — PII scrubber + GDPR erase
• AMP for Email + DSN + streaming raw MIME (nodemailer parity) #91 — AMP + DSN + raw streaming MIME
• Image CID auto-rewrite for embedded images #92 — Image CID auto-rewrite

Deferred

• [cli] unemail dev — preview server + compat checker #52 — CLI (own milestone)

Research sources

• Competitor audit: nodemailer, resend-node, sendgrid-nodejs, mailgun.js, postmark.js, @aws-sdk/client-sesv2, upyo, react-email, novu, knock, courier, svix, mailpit, mailtrap
• Pain points: RFC 8058 (Gmail/Yahoo bulk sender rules 2024), DKIM rotation (Valimail), parsedmarc, ARC spec, BIMI VMCs, MTA-STS/TLS-RPT, FBL/ARF (M3AAWG), edge runtime incompatibilities (Cloudflare, Vercel)
• Internal audit: 36 DONE / 23 PARTIAL / 117 MISSING across 10 categories of functionality

[productdevbook]

v1.1 cycle complete. All 36 issues shipped (4 via PR #94, 22 direct to main in 5 atomic batches).

Final scope

Compliance

• Auto-inject List-Unsubscribe + RFC 8058 one-click headers #57 List-Unsubscribe + RFC 8058 one-click
• Suppression list primitive (bounce + complaint + unsubscribe store) #59 Suppression store + middleware
• Preferences store + category-based opt-out (preference center) #84 Preferences store + middleware
• PII scrubber middleware (body + attachments + recipient redaction) #90 PII scrubber

Deliverability

• DKIM signing inside SMTP driver (RSA + Ed25519, Web-Crypto) #58 DKIM signing (RSA + Ed25519)
• ARC signer (Authenticated Received Chain) for intermediaries #78 ARC signer
• MTA-STS / TLS-RPT policy generator + ingester #79 MTA-STS + TLS-RPT
• DMARC aggregate (RUA) report parser #69 DMARC RUA parser
• Feedback loop (FBL / ARF) report parser #80 FBL/ARF parser

Core / Types

• Template variables pass-through across provider drivers #60 Template variables across 7 drivers
• Queue worker should respect scheduledAt (deferred sends) #61 Queue scheduledAt
• SendGrid-style personalizations (per-recipient substitutions + batch) #63 SendGrid personalizations + fan-out
• ICS calendar invite builder (icalEvent parity) #64 ICS calendar invite builder
• Driver lifecycle: cancel(id) and retrieve(id) (Resend parity) #65 driver.cancel / driver.retrieve
• Per-message tracking + sandbox mode + custom args #66 tracking / sandbox / metadata
• Typed getInstance() and provider-SDK branded returns #67 Typed getInstance() escape hatch
• Typed Address primitive with RFC 5322 + SMTPUTF8 validation #81 Address primitive
• Result<T> helpers: unwrap, isOk, isErr, tryAsync #88 Result helpers
• Async iterator for sendBatch streaming #89 sendBatchStream async iterator
• AMP for Email + DSN + streaming raw MIME (nodemailer parity) #91 AMP + raw MIME

Middleware

• OAuth2 refresh middleware (Gmail, Microsoft 365 presets) #62 OAuth2 refresh (Gmail, Microsoft 365)
• Provider-aware rate-limit middleware (proactive Retry-After bucketing) #75 Per-provider rate-limit presets
• Dedup + idempotency middleware (content-hash guard) #82 Dedupe middleware
• Retry jitter variants + dead-letter routing #83 Retry jitter variants + dead-letter
• Prometheus / OTLP metrics emitter middleware #86 Prometheus metrics

Observability

• Unified event stream (send.queued → delivered → opened → bounced) #70 Unified event stream (send + webhook merged)

Render

• Preheader text + inline-CSS (juice) + dark-mode hooks for HTML pipeline #73 Preheader + juice + dark-mode pipeline
• Handlebars / Liquid / i18n template adapters #87 Handlebars + Liquid + i18n
• Image CID auto-rewrite for embedded images #92 CID auto-rewrite

Inbound

• Reply stripper + thread stitcher for inbound #68 Reply stripper + thread stitcher
• Standard Webhooks (standardwebhooks.com) reference verifier #71 Standard Webhooks reference verifier
• SES inbound adapter via SNS #85 SES inbound via SNS

DX / Packaging

• More test matchers + snapshot + recipient-address helpers #74 Test matchers + snapshot helper
• Multi-region driver presets (Mailgun EU vs US, etc.) #76 Multi-region driver presets (Mailgun EU)
• BullMQ + pg-boss + SQS queue adapters #77 BullMQ + pg-boss + SQS queue adapters
• Per-package tree-shake split: @unemail/resend, @unemail/ses, @unemail/smtp #72 Packaging RFC (stay on single-package model for v1.x)

Numbers

• 18 commits on main
• 251 tests (up from 141 at v1.0)
• Zero runtime dependency additions
• Zero breaking changes (every new field/method optional)
• Dist: ~240 kB / 167 files

Follow-ups deferred out of v1.1

• [cli] unemail dev — preview server + compat checker #52 CLI (own milestone)