sently 0.7.2 → 0.9.0

package/AGENTS.md

@@ -0,0 +1,34 @@
+# sently — agent contract
+
+sently is a runtime-agnostic TypeScript messaging library (email, SMS, WhatsApp, Web Push) for Node.js, Bun, Deno, and Cloudflare Workers. ESM-only, zero runtime dependencies.
+
+## Sently-first provider model
+
+Apps use **channel senders**, not vendor SDKs:
+
+| Channel | Sender | Contract |
+|---------|--------|----------|
+| Email | `createMailer` / `createSMTPMailer` | `Transport` |
+| SMS | `createSmsSender` | `SmsTransport` |
+| WhatsApp | `createWhatsAppSender` | `WhatsAppTransport` |
+| Push | `createPushSender` | `PushTransport` |
+
+Providers are transports under those senders. Vendor extras (OTP, account utilities) live on the concrete transport class — never on the shared channel contract.
+
+## Docs
+
+- Handbook: `site/content/docs/` (Fumadocs)
+- Machine index: `/llms.txt` on the docs site
+- Dev notes: `CLAUDE.md`
+
+## Commands
+
+```sh
+bun install
+bun test
+bun run site:dev
+bun run site:build
+bun run verify
+```
+
+Do not invent APIs. Prefer imports from published subpaths (`sently/mailer`, `sently/sms`, `sently/transports/*`).

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 ## [Unreleased]
 
+## [0.9.0] — 2026-08-01
+
+### Added
+
+- **Channel senders** — `createSmsSender` (`sently/sms`), `createWhatsAppSender`
+  (`sently/whatsapp`), `createPushSender` (`sently/push`) alongside email; each
+  sender supports plugins and lifecycle hooks
+- **SMS transports** — Twilio, Taqnyat SMS, Msegat (`sently/transports/twilio-sms`,
+  `taqnyat-sms`, `msegat`); vendor OTP helpers stay on the transport class
+- **WhatsApp transports** — WhatsApp Cloud API, Taqnyat WhatsApp
+  (`sently/transports/whatsapp-cloud`, `taqnyat-whatsapp`)
+- **Web Push transport** — VAPID Web Push (`sently/transports/webpush`)
+- **Email transports** — Sndr, Taqnyat Mail (`sently/transports/sndr`,
+  `taqnyat-mail`)
+- **Sndr webhooks** — `parseSndrWebhook` / `verifySndrSignature`
+  (`sently/webhooks/sndr`, also via `sently/webhooks`)
+- **Per-provider webhook subpaths** — `sently/webhooks/{brevo,mailgun,postmark,
+  resend,sendgrid,ses,sndr}` for tree-shakeable imports
+- **Docs site** — Next.js + Fumadocs handbook under `site/` (`bun run site:dev`)
+- **Web Push interop example** — `examples/webpush-interop`
+- **`AGENTS.md`** — agent contract for the sently-first provider model (replaces
+  `CLAUDE.md`; published with the package)
+
+### Changed
+
+- **Library scope** — channel-first messaging (email, SMS, WhatsApp, push), not
+  email-only; package description and README updated accordingly
+- **Docs site branding** — real sently wordmark / mark in the header, homepage,
+  404, favicon, Apple touch icon, and docs OG images; README shows the logo
+
+## [0.8.0] — 2026-06-07
+
+### 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`)
+- **`SendResult.provider`** and **`SendResult.providerIndex`** — set by `FallbackTransport` to identify which provider handled the send
+- **`durationMs`** optional third argument on `onSuccess` / `onError` mailer hooks (backward compatible)
+- **`consoleObserver`** (`sently/observability`) — ready-made console logging hooks; also exported from main `"sently"` barrel
+- **Mailer `onFallback` hook** — `onFallback(ctx, failedProvider, nextProvider, error)` on `MailerHooks`; wired automatically when using `FallbackTransport` or `WeightedFallbackTransport`
+- **Provider cooldowns** — `FallbackTransport(transports, { cooldownMs })` skips unhealthy providers until cooldown expires; shared across `WeightedFallbackTransport` sends
+- **`verifyAll()`** on `FallbackTransport` / `WeightedFallbackTransport` — per-provider `{ ok, providers: [{ provider, ok, message? }] }` result; `verify()` still returns the first healthy provider
+- **`WeightedFallbackTransport`** (`sently/transports/weighted-fallback`) — weighted-random primary provider with failover through remaining providers
+- **`Transport.provider`** — stable provider identifier on every transport class; `getProviderLabel()` prefers it over `constructor.name` inference
+- **`CloudflareEmailTransport`** (`sently/transports/cloudflare-email`) — Workers `send_email` binding transport (not fetch HTTP)
+
 ## [0.7.2] — 2026-05-31
 
 ### Fixed
@@ -376,4 +422,6 @@ Remaining gaps (SOCKS proxy, iCal) are out of scope by design.
 
 ## [0.1.0] — 2026-05-29
 
-Initial release.
+### Added
+
+- Initial release.