sently 0.8.0 → 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,36 @@
 
 ## [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
@@ -392,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.