sently 0.9.0 → 0.9.1

package/AGENTS.md

@@ -19,7 +19,6 @@ Providers are transports under those senders. Vendor extras (OTP, account utilit
 
 - Handbook: `site/content/docs/` (Fumadocs)
 - Machine index: `/llms.txt` on the docs site
-- Dev notes: `CLAUDE.md`
 
 ## Commands
 

package/CHANGELOG.md

@@ -2,9 +2,18 @@
 
 ## [Unreleased]
 
+## [0.9.1] — 2026-08-01
+
+### 🐛 Fixed
+
+- **SNDR live suite opt-in** — require `SNDR_LIVE=1` (plus credentials) so
+  `bun run verify` stays offline-safe when `.env` has keys
+- **Docs header geometry gate** — assert the home brand cell against
+  `HeroIntro`'s left-pane width after the hero split moved out of `page.tsx`
+
 ## [0.9.0] — 2026-08-01
 
-### Added
+### ✨ Added
 
 - **Channel senders** — `createSmsSender` (`sently/sms`), `createWhatsAppSender`
   (`sently/whatsapp`), `createPushSender` (`sently/push`) alongside email; each
@@ -25,7 +34,7 @@
 - **`AGENTS.md`** — agent contract for the sently-first provider model (replaces
   `CLAUDE.md`; published with the package)
 
-### Changed
+### ♻️ Changed
 
 - **Library scope** — channel-first messaging (email, SMS, WhatsApp, push), not
   email-only; package description and README updated accordingly
@@ -34,7 +43,7 @@
 
 ## [0.8.0] — 2026-06-07
 
-### Added
+### ✨ Added
 
 - **`FallbackTransport`** (`sently/transports/fallback`) — provider failover through an ordered transport list; composes with `RetryTransport`; `FallbackError.attempts` records `{ provider, error }` per failed attempt
 - **Five HTTP providers:** MailerSend, Plunk, SparkPost, Mailtrap, Loops (`sently/transports/mailersend`, `plunk`, `sparkpost`, `mailtrap`, `loops`)
@@ -50,14 +59,14 @@
 
 ## [0.7.2] — 2026-05-31
 
-### Fixed
+### 🐛 Fixed
 
 - Publish workflow runs `bun run build` before registry steps and publishes **npm before JSR** so a failed npm step does not leave JSR ahead of npm
 - `scripts/publish.ts` `syncVersion()` skips rewriting `jsr.json` when content is unchanged (avoids dirty working tree between CI publish steps)
 
 ## [0.7.1] — 2026-05-31
 
-### Documentation
+### 📚 Documentation
 
 - README Nodemailer comparison updated for **v8.0.10** (~58 KB gzip, zero deps, 2026 releases)
 - Bundle size figures refreshed from `bun run measure:size:md` (~6.1 KB HTTP, ~15 KB SMTP, ~2.6 KB `sently/mailer`)
@@ -65,7 +74,7 @@
 
 ## [0.7.0] — 2026-05-31
 
-### Breaking + Migration
+### 💥 Breaking + Migration
 
 Summary:
 
@@ -83,13 +92,13 @@ Summary:
   transport-only main `createMailer`; v0.5.x bulk-send behavior (native batch, default
   2 req/s throttle, `SendResult.batchError`).
 
-### Added
+### ✨ Added
 
 - **`INVALID_CONFIG`** stable error code for misconfigured mailer factories
 - **`SMTPMailerOptions`** type for SMTP factory config
 - README decision-tree section and Microsoft 365 OAuth2 example
 
-### Changed
+### ♻️ Changed
 
 - **`BulkSendOptions.concurrency` TSDoc** — documents default `1` (matches implementation)
 - Bundle size budgets updated for slimmer main entry
@@ -97,12 +106,12 @@ Summary:
 
 ## [0.6.2] — 2026-05-31
 
-### Added
+### ✨ Added
 
 - **`sently/smtp`** subpath — SMTP `createMailer` (`host` / `port` / `auth`, pooling,
   adapters) isolated from the main entry for smaller HTTP app bundles
 
-### Changed
+### ♻️ Changed
 
 - **Breaking:** main `createMailer` from `sently` is transport-only (same as
   `sently/mailer`). SMTP relay apps use `import { createMailer } from "sently/smtp"`
@@ -118,18 +127,18 @@ Summary:
 
 ## [0.6.1] — 2026-05-31
 
-### Fixed
+### 🐛 Fixed
 
 - **Build** — emit `dist/core/errors.js` so the main barrel and Node/Deno smoke
   tests resolve `SentlyError` imports after `bun run build`
 
-### Changed
+### ♻️ Changed
 
 - Bundle size budgets adjusted for minor measurement drift on CI runners
 
 ## [0.6.0] — 2026-05-31
 
-### Added
+### ✨ Added
 
 - **`sently/errors`** — unified `SentlyError` base class with stable machine-readable
   codes (`RATE_LIMITED`, `BAD_REQUEST`, `SMTP_AUTH_FAILED`, etc.); all existing
@@ -142,13 +151,13 @@ Summary:
 - **`AUDIT-v0.6.md`** — README capability audit with file/line proof (all claims
   verified implemented, including CRAM-MD5)
 
-### Changed
+### ♻️ Changed
 
 - Bundle size budgets updated for expanded mailer (hooks) and error hierarchy
 
 ## [0.5.2] — 2026-05-31
 
-### Fixed
+### 🐛 Fixed
 
 - **Build** — `dist/webhooks.js` and `dist/react.js` are generated from source instead
   of bundled with code-splitting, fixing `SyntaxError: Export 'k' is not defined` when
@@ -156,12 +165,12 @@ Summary:
 
 ## [0.5.1] — 2026-05-31
 
-### Breaking
+### 💥 Breaking
 
 - **Main barrel** — `reactPlugin` and `ReactMailOptions` are no longer exported from
   `"sently"`. Import them from `"sently/react"` instead.
 
-### Fixed
+### 🐛 Fixed
 
 - **Webhook signatures** — `verifyResendSignature` and `verifyMailgunSignature` now
   compare decoded signature bytes with constant-time `timingSafeEqual` (Web Crypto only)
@@ -169,7 +178,7 @@ Summary:
 - **Batch sendBulk** — per-chunk failure isolation, per-message partial batch errors
   (`SendResult.batchError`), and rate limiting between batch HTTP requests (default 2/s)
 
-### Changed
+### ♻️ Changed
 
 - `RateLimiter` extracted to `src/core/rate-limiter.ts` (shared by pool and mailer)
 - `Transport.batchMax` on `ResendTransport`; `BulkSendOptions.rateDelta` / `rateLimit`
@@ -177,7 +186,7 @@ Summary:
 
 ## [0.5.0] — 2026-05-31
 
-### Added
+### ✨ Added
 
 - **`sently/react`** — React Email integration via `reactPlugin()`; optional peers
   `react` and `@react-email/render`; `options.react` on `MailOptions`
@@ -193,7 +202,7 @@ Summary:
   optional Mailgun HMAC and Resend Svix signature verification helpers
 - **`deduped`** flag on `SendResult` for idempotency cache hits
 
-### Changed
+### ♻️ Changed
 
 - `sendBulk` uses native batch endpoints when the transport implements
   `sendBatch`; concurrent per-message fallback unchanged for other transports
@@ -202,7 +211,7 @@ Summary:
 
 ## [0.4.7] — 2026-05-30
 
-### Added
+### ✨ Added
 
 - **`sently/mailer` entry** — transport-only `createMailer` without SMTP code in the
   bundle (~4.3 KB with HTTP transports vs ~14 KB from the main entry)
@@ -215,7 +224,7 @@ Summary:
   for docs and CI
 - **Deno and Cloudflare adapter smoke tests** in CI
 
-### Changed
+### ♻️ Changed
 
 - Lazy-load SMTP transport and pool from `createMailer` when using SMTP config
 - Extract `MailerImpl` to `src/mailer.ts`; full `createMailer` in `detect.ts` delegates
@@ -226,7 +235,7 @@ Summary:
 - **Pinned devDependency versions** (Biome 2.4.16, TypeScript 6.0.3, `@types/node`
   25.9.1, MCP SDK 1.29.0)
 
-### Documentation
+### 📚 Documentation
 
 - README **Bundle Size** section — import-path guide, common stacks, per-subpath
   tables, and HTTP stack breakdown
@@ -235,7 +244,7 @@ Summary:
 
 ## [0.4.6] — 2026-05-30
 
-### Documentation
+### 📚 Documentation
 
 - Documented all remaining exported symbols (class members, interface
   properties, and internal helpers) for 100% JSR symbol documentation
@@ -244,7 +253,7 @@ Summary:
 
 ## [0.4.5] — 2026-05-30
 
-### Documentation
+### 📚 Documentation
 
 - Added `@module` documentation to the `./pool` entrypoint
 - Documented exported interface properties and public API methods across
@@ -253,7 +262,7 @@ Summary:
 
 ## [0.4.4] — 2026-05-30
 
-### Security
+### 🔒 Security
 
 - Fixed SigV4 date format: slice(0,15) not slice(0,16) — all real
   SES requests were producing malformed x-amz-date headers
@@ -281,7 +290,7 @@ Summary:
 
 ## [0.4.3] — 2026-05-30
 
-### Added
+### ✨ Added
 
 - `llms.txt` for LLM/agent discovery (install, quick example, subpath
   exports, and when-to-use guidance)
@@ -290,7 +299,7 @@ Summary:
 - `CLAUDE.md` repository map for agents (core entry, adapters,
   transports, tests, build)
 
-### Changed
+### ♻️ Changed
 
 - README positioning, HTTP transport reference table, plugin docs
   reorder, and tree-shaking callout
@@ -298,7 +307,7 @@ Summary:
 
 ## [0.4.2] — 2026-05-30
 
-### Fixed
+### 🐛 Fixed
 
 - CI: replaced node -e dynamic import with scripts/smoke.mjs
   (top-level await ESM) for reliable Node.js smoke testing
@@ -308,7 +317,7 @@ Summary:
 
 ## [0.4.1] — 2026-05-30
 
-### Fixed
+### 🐛 Fixed
 
 - CI: use locally installed tsc (node_modules/.bin/tsc) in build.ts
   instead of bunx tsc to avoid runtime npm downloads in CI
@@ -319,7 +328,7 @@ Summary:
 
 ## [0.4.0] — 2026-05-30
 
-### Added
+### ✨ Added
 
 - `PreviewTransport` — writes emails to disk as .eml or HTML for local development
 - `RetryTransport` — decorator transport with exponential/linear/fixed backoff
@@ -332,14 +341,14 @@ Summary:
 - `attachment.path` basePath guard (opt-in) in resolveAttachments
 - GitHub Actions CI matrix: unit tests (Bun), smoke test (Node 22), SMTP integration (Mailpit)
 
-### Fixed
+### 🐛 Fixed
 
 - `detectRuntime()` priority hardened: Bun checked before Node.js process globals
 - Cloudflare Workers detection uses positive signature (caches + UA), not absence of other runtimes
 
 ## [0.3.4] — 2026-05-30
 
-### Fixed
+### 🐛 Fixed
 
 - Stale `sendx` references in package.json, build.ts, PROGRESS.md
 - JSR badge URL now matches jsr.json scope exactly
@@ -349,25 +358,25 @@ Summary:
   and uses Promise.allSettled to drain in-flight messages
 - Audited all buildMIME() call sites — await confirmed present
 
-### Added
+### ✨ Added
 
 - `engines` field in package.json (Node >= 18, Bun >= 1.0)
 
 ## [0.3.3] — 2026-05-29
 
-### Fixed
+### 🐛 Fixed
 
 - Corrected JSR package name in README from `@sently/sently` to `@alialnaghmoush/sently`
 
 ## [0.3.2] — 2026-05-29
 
-### Fixed
+### 🐛 Fixed
 
 - Biome formatting in MIME header builder (`src/core/mime.ts`) so `bun lint` passes
 
 ## [0.3.1] — 2026-05-29
 
-### Security
+### 🔒 Security
 
 - Fixed CRLF header injection: `sanitizeHeaderValue()` strips CR/LF
   from Subject, display names, and custom headers in MIME builder
@@ -383,7 +392,7 @@ Summary:
 
 ## [0.3.0] — 2026-05-29
 
-### Added
+### ✨ Added
 
 - Plugin system: `plugins` array in `createMailer()` config
   Plugins are `(options: MailOptions) => MailOptions | Promise<MailOptions>` functions
@@ -393,14 +402,14 @@ Summary:
 - `BrevoTransport` — Brevo (formerly Sendinblue) HTTP API
 - `TLSOptions.minVersion` — set minimum TLS version for legacy SMTP servers
 
-### Parity milestone
+### 🏁 Parity milestone
 
 sently now covers ~98% of Nodemailer feature parity for modern use cases.
 Remaining gaps (SOCKS proxy, iCal) are out of scope by design.
 
 ## [0.2.0] — 2026-05-29
 
-### Added
+### ✨ Added
 
 - DKIM signing (RSA-SHA256 and Ed25519-SHA256) via `SMTPConfig.dkim`
 - OAuth2 / XOAUTH2 authentication via `SMTPAuth.type = 'OAUTH2'`
@@ -408,7 +417,7 @@ Remaining gaps (SOCKS proxy, iCal) are out of scope by design.
 - Rate limiting via `PoolConfig.rateDelta` / `PoolConfig.rateLimit`
 - CRAM-MD5 authentication (pure-JS HMAC-MD5)
 
-### Changed
+### ♻️ Changed
 
 - npm package name is `sently`; JSR package name is `@sently/sently`
 - `SMTPAuth.pass` is now optional (was required in v0.1)
@@ -416,12 +425,12 @@ Remaining gaps (SOCKS proxy, iCal) are out of scope by design.
 - `selectAuthMethod` priority: XOAUTH2 > CRAM-MD5 > LOGIN > PLAIN
 - `createMailer()` uses `SMTPPool` automatically when `pool: true`
 
-### Fixed
+### 🐛 Fixed
 
 - CRAM-MD5 stub now fully implemented
 
 ## [0.1.0] — 2026-05-29
 
-### Added
+### ✨ Added
 
 - Initial release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sently",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Runtime-agnostic messaging library for Node.js, Bun, Deno, and Cloudflare Workers. Channel-first email, SMS, WhatsApp, and push with pluggable provider transports.",
   "type": "module",
   "sideEffects": false,