sently 0.10.0 → 1.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sently",
-  "version": "0.10.0",
-  "description": "Runtime-agnostic messaging library for Node.js, Bun, Deno, and Cloudflare Workers. Channel-first email, SMS, WhatsApp, and push with pluggable provider transports.",
+  "version": "1.0.1",
+  "description": "Runtime-agnostic channel-delivery library for Node.js, Bun, Deno, and Cloudflare Workers. One sender shape, one error model, and one retry path across email, SMS, WhatsApp, and push — with pluggable provider transports.",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -11,6 +11,7 @@
     "README.md",
     "LICENSE",
     "CHANGELOG.md",
+    "SECURITY.md",
     "AGENTS.md",
     "site/content/docs"
   ],
@@ -58,11 +59,18 @@
     "typescript": "6.0.3"
   },
   "keywords": [
+    "messaging",
     "email",
+    "sms",
+    "whatsapp",
+    "push",
+    "web-push",
+    "fcm",
     "smtp",
     "mailer",
     "nodemailer",
     "nodemailer-alternative",
+    "channel-first",
     "bun",
     "deno",
     "cloudflare-workers",
@@ -75,6 +83,7 @@
     "ses",
     "aws-ses",
     "brevo",
+    "twilio",
     "dkim",
     "oauth2",
     "transactional-email",
@@ -179,6 +188,10 @@
       "import": "./dist/transports/mailtrap.js",
       "types": "./dist/transports/mailtrap.d.ts"
     },
+    "./transports/mailpit": {
+      "import": "./dist/transports/mailpit.js",
+      "types": "./dist/transports/mailpit.d.ts"
+    },
     "./transports/loops": {
       "import": "./dist/transports/loops.js",
       "types": "./dist/transports/loops.d.ts"

package/site/content/docs/ai/llms-txt.mdx

@@ -6,7 +6,52 @@ source: "site/app/llms.txt/route.ts"
 ---
 
 The docs site serves `/llms.txt` and `/llms-full.txt` for concise and complete machine-readable documentation.
+Use the live site indexes when an agent needs current handbook navigation.
 
-Use `/llms.txt` for navigation and `/llms-full.txt` when an agent needs page content.
+<Callout title="The one rule">
+  Prefer the docs site `/llms.txt` over the repo-root `llms.txt` file when both exist — the site index is generated from the handbook MDX.
+</Callout>
 
-<Cards><Card title="MCP" href="/docs/ai/mcp" /></Cards>
+## Quick start
+
+<Steps>
+  <Step title="Fetch the short index">
+
+```text
+https://sently.omqkhafi.dev/llms.txt
+```
+
+  </Step>
+  <Step title="Fetch full page text when needed">
+
+```text
+https://sently.omqkhafi.dev/llms-full.txt
+```
+
+  </Step>
+</Steps>
+
+## Related agent surfaces
+
+| Resource | Use |
+| --- | --- |
+| Site `/llms.txt` | Navigation + short model |
+| Site `/llms-full.txt` | Full handbook dump |
+| Repo `AGENTS.md` | Channel-first contract |
+| [Stability](/docs/get-started/stability) | What is frozen at 1.x |
+| [Compare](/docs/guides/compare) | Library vs platform positioning |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Why does the repo-root llms.txt disagree with the site?">
+    The live route is built from `site/content/docs`. Refresh or regenerate from the handbook after docs changes.
+  </Accordion>
+</Accordions>
+
+## Next
+
+<Cards>
+  <Card title="MCP" href="/docs/ai/mcp" />
+  <Card title="Introduction" href="/docs/get-started/introduction" />
+</Cards>

package/site/content/docs/channels/email.mdx

@@ -91,10 +91,13 @@ const mailer = await createSMTPMailer({
 - [Email options](../reference/mail-options)
 - [Transport contracts](../reference/transport-contracts)
 - [Hooks](./hooks)
+- [Mailpit](../transports/mailpit) — local catcher for development
+- [Preview](../decorators/preview) — write `.eml` files to disk
 
 ## Next
 
 <Cards>
   <Card title="Transports" href="/docs/transports" />
+  <Card title="Mailpit" href="/docs/transports/mailpit" />
   <Card title="Send in bulk" href="/docs/guides/send-bulk" />
 </Cards>

package/site/content/docs/channels/index.mdx

@@ -6,7 +6,7 @@ source: "README.md"
 ---
 
 Choose a channel sender for the kind of message your application sends.
-Each sender accepts a provider transport, so delivery providers can change without rewriting send calls.
+Each sender accepts a provider transport — retry, fallback, and `SentlyError` codes stay the same as you add channels.
 
 <Callout title="The one rule">Application code calls a sently channel sender; provider-specific code stays in its transport.</Callout>
 
@@ -68,6 +68,8 @@ await sms.send({
 ## Learn more
 
 - [Choose an entrypoint](../get-started/entrypoints)
+- [Support matrix](../get-started/support-matrix)
+- [Failover](../guides/failover)
 - [Browse transports](../transports)
 
 ## Next

package/site/content/docs/channels/push.mdx

@@ -78,6 +78,9 @@ Shared fields: `title`, `body`, optional `data`, `icon`, `ttl`, `messageId`.
   <Accordion title="Why does the transport reject my endpoint?">
     Web Push validates subscription endpoint hosts before sending. Add only exact private relay hostnames with `allowedEndpointHosts` when needed.
   </Accordion>
+  <Accordion title="Why does FCM reject my subscription object?">
+    `FcmTransport` requires `token`. Pass a Web Push `subscription` only to `WebPushTransport`.
+  </Accordion>
   <Accordion title="Why is the endpoint redacted in hooks?">
     Endpoint paths and FCM tokens are long-lived credentials, so hook context keeps only a redacted fingerprint.
   </Accordion>
@@ -88,6 +91,7 @@ Shared fields: `title`, `body`, optional `data`, `icon`, `ttl`, `messageId`.
 - [Push options](../reference/push-options)
 - [Web Push](../transports/webpush)
 - [FCM](../transports/fcm)
+- [Failover](../guides/failover)
 - [Hooks](./hooks)
 
 ## Next

package/site/content/docs/decorators/fallback.mdx

@@ -53,9 +53,14 @@ Successful sends include `provider` and `providerIndex` for the transport that h
   </Accordion>
 </Accordions>
 
+## Learn more
+
+- [Failover guide](/docs/guides/failover) — retry-then-fallback recipes across channels
+
 ## Next
 
 <Cards>
+  <Card title="Failover guide" href="/docs/guides/failover" />
   <Card title="Weighted fallback" href="/docs/decorators/weighted-fallback" />
   <Card title="Retry" href="/docs/decorators/retry" />
 </Cards>

package/site/content/docs/decorators/index.mdx

@@ -55,13 +55,14 @@ const sms = createSmsSender({
 
 ## Learn more
 
+- [Failover recipe](../guides/failover) — retry inside a provider, then fail over
 - [Transports](../transports)
 - [Hooks](../channels/hooks)
 
 ## Next
 
 <Cards>
+  <Card title="Failover guide" href="/docs/guides/failover" />
   <Card title="Retry" href="/docs/decorators/retry" />
   <Card title="Fallback" href="/docs/decorators/fallback" />
-  <Card title="Transports" href="/docs/transports" />
 </Cards>

package/site/content/docs/decorators/preview.mdx

@@ -6,29 +6,72 @@ source: "src/transports/preview.ts"
 ---
 
 Write email previews to disk instead of delivering them.
+Use this when you want a local `.eml` or HTML file for the welcome email without a mail server.
 
 <Callout title="The one rule">Preview is for development, not delivery.</Callout>
 
-## Configuration
-
-`outDir`, `open`, and `format` are optional; defaults are `./.emails`, false, and `eml`.
+## Quick start
 
-<Steps><Step title="Wrap an email transport">
+<Steps>
+  <Step title="Create the preview transport">
 
 ```ts
+import { createMailer } from "sently/mailer";
 import { PreviewTransport } from "sently/transports/preview";
 
 const transport = new PreviewTransport({ outDir: ".emails", open: true });
+const mailer = await createMailer({ transport });
 ```
 
-</Step><Step title="Create the mailer">
+  </Step>
+  <Step title="Send and open the file">
 
 ```ts
-const mailer = await createMailer({ transport });
+await mailer.send({
+  from: "dev@example.com",
+  to: "you@example.com",
+  subject: "Welcome",
+  text: "Thanks for joining.",
+});
 ```
 
-</Step></Steps>
+Files land under `outDir` (default `./.emails`). With `open: true`, the OS opens the written file.
+
+  </Step>
+</Steps>
+
+## Configuration
+
+| Option | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `outDir` | `string` | `"./.emails"` | Directory for preview files |
+| `open` | `boolean` | `false` | Open the file after write |
+| `format` | `"eml" \| "html"` | `"eml"` | Full MIME or HTML body only |
+
+`provider` is `"preview"`. `verify()` always succeeds.
+
+For a real SMTP catcher with a web UI, use [Mailpit](/docs/transports/mailpit) instead.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Does Preview wrap another transport?">
+    No. `PreviewTransport` is the delivery transport — it writes to disk and does not call a provider.
+  </Accordion>
+  <Accordion title="Where is the file?">
+    Check `outDir` (default `./.emails`). The console logs `[sently preview] Written: …` on each send.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Mailpit](/docs/transports/mailpit) — local SMTP catcher with inbox API
+- [Email channel](/docs/channels/email) — `createMailer` contract
 
-<Accordions><Accordion title="Does this replace the inner provider?">No. It delegates sends to the wrapped transport.</Accordion></Accordions>
+## Next
 
-<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>
+<Cards>
+  <Card title="Mailpit" href="/docs/transports/mailpit" />
+  <Card title="Email channel" href="/docs/channels/email" />
+  <Card title="Decorators" href="/docs/decorators" />
+</Cards>

package/site/content/docs/get-started/entrypoints.mdx

@@ -88,7 +88,7 @@ No. `createMailer` requires a transport. Import `createSMTPMailer` from `sently/
 
 <Accordion title="Where do provider transports come from?">
 
-Import the concrete transport from its exported `sently/transports/*` subpath, such as `sently/transports/sndr` or `sently/transports/resend`.
+Import the concrete transport from its exported `sently/transports/*` subpath, such as `sently/transports/sndr`, `sently/transports/resend`, or `sently/transports/mailpit`.
 
 </Accordion>
 
@@ -103,13 +103,15 @@ HTTP providers were removed from the main barrel so bare Node/Deno imports do no
 ## Learn more
 
 - [Export reference](/docs/reference/exports) — full entrypoint map
+- [Support matrix](/docs/get-started/support-matrix) — Supported vs Available
+- [Stability policy](/docs/get-started/stability) — frozen entrypoints at 1.x
 - [All transports](/docs/transports) — providers by channel
-- [Bundle size](/docs/guides/bundle-size) — keep stacks small
+- [Bundle size](/docs/guides/bundle-size) — keep stacks small on Workers
 
 ## Next
 
 <Cards>
   <Card title="Exports reference" description="Public package entrypoints." href="/docs/reference/exports" />
+  <Card title="Support matrix" description="Production support promise." href="/docs/get-started/support-matrix" />
   <Card title="Email channel" description="createMailer and MailOptions." href="/docs/channels/email" />
-  <Card title="SNDR" description="HTTP email via SNDR." href="/docs/transports/sndr" />
 </Cards>

package/site/content/docs/get-started/index.mdx

@@ -5,10 +5,16 @@ icon: FolderOpen
 source: "README.md"
 ---
 
-Install sently and send your first message.
+Install sently and send your first message. Learn the channel model once, then add SMS or push without a new failure model.
 
 <Cards>
   <Card title="Introduction" href="/docs/get-started/introduction" />
   <Card title="Installation" href="/docs/get-started/installation" />
-  <Card title="Quick start" href="/docs/quick-start" />
+  <Card title="Entrypoints" href="/docs/get-started/entrypoints" />
+  <Card title="Runtimes" href="/docs/get-started/runtimes" />
+  <Card title="Channels" href="/docs/channels" />
+  <Card title="Migrate from Nodemailer" href="/docs/get-started/migrate-nodemailer" />
+  <Card title="Stability policy" href="/docs/get-started/stability" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
+  <Card title="Non-goals" href="/docs/get-started/non-goals" />
 </Cards>

package/site/content/docs/get-started/introduction.mdx

@@ -5,8 +5,8 @@ icon: Compass
 source: "README.md"
 ---
 
-sently sends email, SMS, WhatsApp, and push (Web Push or FCM) without making provider SDK calls your application API.
-Choose the channel sender first, then attach the provider transport that performs delivery.
+sently is the channel-delivery layer for email, SMS, WhatsApp, and push (Web Push or FCM).
+Choose a channel sender first, then attach a provider transport — so adding SMS or push later does not invent a new error and retry model in your app.
 
 <Callout title="The one rule">Use `createMailer`, `createSmsSender`, `createWhatsAppSender`, or `createPushSender` in app code; swap transports when provider configuration changes.</Callout>
 
@@ -67,11 +67,15 @@ Email factories are asynchronous. The other channel factories return their sende
 
 - [Install sently](./installation)
 - [Choose an entrypoint](./entrypoints)
+- [Stability policy](./stability)
+- [Support matrix](./support-matrix)
+- [Compare](/docs/guides/compare)
 - [Explore channels](../channels)
 
 ## Next
 
 <Cards>
-  <Card title="Email quick start" href="/docs/quick-start/email" />
+  <Card title="Email channel" href="/docs/channels/email" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
   <Card title="Channels" href="/docs/channels" />
 </Cards>

package/site/content/docs/get-started/meta.json

@@ -7,6 +7,9 @@
     "installation",
     "entrypoints",
     "runtimes",
-    "migrate-nodemailer"
+    "migrate-nodemailer",
+    "stability",
+    "support-matrix",
+    "non-goals"
   ]
 }

package/site/content/docs/get-started/migrate-nodemailer.mdx

@@ -2,22 +2,149 @@
 title: Migrate from Nodemailer
 description: Move SMTP configuration and message fields to sently incrementally.
 icon: ArrowRightLeft
-source: "README.md"
+source: "src/smtp-mailer.ts"
 ---
 
-Keep your message object, replace transporter construction, and await the sently factory.
+Keep your welcome email, receipt, or password-reset fields (`from`, `to`, `subject`, `text` / `html`).
+Replace `createTransport` with `createSMTPMailer`, rename `sendMail` to `send`, and `await` the factory before the first send.
+
+<Callout title="The one rule">
+  Use `createSMTPMailer` for relay host/port/auth. Use `createMailer` only when you already have an explicit transport.
+</Callout>
+
+## Quick start
+
+<Steps>
+  <Step title="Create the mailer">
 
 ```ts
 import { createSMTPMailer } from "sently/smtp";
 
 const mailer = await createSMTPMailer({
   host: "smtp.example.com",
+  port: 587,
   auth: { user: "user@example.com", pass: process.env.SMTP_PASSWORD! },
 });
 ```
 
-<Callout title="The one rule">Use `createSMTPMailer` for relay configuration; use `createMailer` only with an explicit transport.</Callout>
+  </Step>
+  <Step title="Send with the same fields">
+
+```diff
+- const info = await transporter.sendMail({
++ const result = await mailer.send({
+    from: "Acme <hello@example.com>",
+    to: "person@example.com",
+    subject: "Welcome",
+    text: "Thanks for joining.",
+  });
+```
+
+  </Step>
+  <Step title="Read the result">
+
+```ts
+console.log(result.messageId, result.accepted, result.rejected);
+```
+
+  </Step>
+</Steps>
+
+## API map
+
+| Nodemailer | sently |
+| --- | --- |
+| `createTransport({ host, port, auth })` | `await createSMTPMailer({ host, port, auth })` |
+| `transporter.sendMail(msg)` | `mailer.send(msg)` |
+| `transporter.verify()` | `mailer.verify()` |
+| `transporter.close()` | `mailer.close()` |
+| `info.messageId` / `accepted` / `rejected` / `response` / `envelope` | Same fields on `SendResult` |
+| HTTP providers via plugins / custom | `createMailer` + `sently/transports/<provider>` |
+
+## Message fields
+
+| Nodemailer | sently |
+| --- | --- |
+| `from` / `to` / `cc` / `bcc` / `replyTo` | Same names on `MailOptions` |
+| `subject`, `text`, `html`, `headers`, `messageId`, `date` | Same names |
+| `priority` | `"high" \| "normal" \| "low"` |
+| `attachments[].filename` / `content` / `path` / `contentType` | Same names |
+| `attachments[].cid` | `attachments[].contentId` |
+| `attachments[].contentDisposition: "inline"` | `attachments[].inline: true` |
+| `icalEvent`, SOCKS proxy options | Not supported — see [Non-goals](/docs/get-started/non-goals) |
+
+## SMTP options
+
+| Option | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `host` | `string` | required | Relay hostname |
+| `port` | `number` | `587` (`465` if `secure`) | SMTP port |
+| `secure` | `boolean` | `false` | Implicit TLS on connect |
+| `auth` | `SMTPAuth` | — | `{ user, pass?, type?, oauth2? }` |
+| `pool` | `boolean` | `false` | Connection pooling |
+| `requireTLS` | `boolean` | `true` when `auth` is set | Refuse AUTH on a cleartext connection |
+| `tls` | `TLSOptions` | — | `rejectUnauthorized`, `servername`, `minVersion` |
+| `connectionTimeout` | `number` | — | Socket connect timeout (ms) |
+| `greetingTimeout` | `number` | — | Wait for SMTP greeting (ms) |
+| `socketTimeout` | `number` | — | Idle socket timeout (ms) |
+
+## Switch to an HTTP provider later
+
+Keep `mailer.send` and change only construction:
+
+```diff
+- import { createSMTPMailer } from "sently/smtp";
+- const mailer = await createSMTPMailer({ host, port, auth });
++ import { createMailer } from "sently/mailer";
++ import { ResendTransport } from "sently/transports/resend";
++ const mailer = await createMailer({
++   transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),
++ });
+```
+
+**Consequence:** message fields stay the same; only the factory and transport change.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title='Error: "SMTP config passed to transport-only createMailer"'>
+    `createMailer` accepts only `{ transport, plugins?, hooks? }`. Move host/port/auth to `createSMTPMailer` from `sently/smtp`.
+  </Accordion>
+  <Accordion title="Do I need to rewrite every message object?">
+    Usually no. Keep `from`, `to`, `subject`, and body fields; change construction and `sendMail` → `send`. Rename attachment `cid` to `contentId` when you use inline images.
+  </Accordion>
+  <Accordion title="Why is createSMTPMailer async?">
+    The factory prepares the runtime SMTP connection path (and optionally the pool) before returning. Always `await` it before `send`.
+  </Accordion>
+  <Accordion title="Is sently a drop-in for every Nodemailer plugin?">
+    No. SOCKS and iCal are intentional non-goals. See [Non-goals](/docs/get-started/non-goals) and [Compare](/docs/guides/compare).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Email channel](/docs/channels/email) — mailer + transport model after you migrate
+- [Mail options](/docs/reference/mail-options) — full `MailOptions` field list
+- [Attachments](/docs/guides/attachments) — `content`, `path`, and `contentId`
+- [Entrypoints](/docs/get-started/entrypoints) — `sently/smtp` vs `sently/mailer`
+- [Support matrix](/docs/get-started/support-matrix) — which runtimes and exports are supported
 
-<Accordions><Accordion title="Why does transport-only createMailer reject host?">It only accepts a `transport`. Move relay configuration to `createSMTPMailer`.</Accordion></Accordions>
+## Next
 
-<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>
+<Cards>
+  <Card
+    title="Email channel"
+    description="Send with createMailer or createSMTPMailer."
+    href="/docs/channels/email"
+  />
+  <Card
+    title="SMTP transport"
+    description="Relay options when you wire SMTPTransport yourself."
+    href="/docs/transports/smtp"
+  />
+  <Card
+    title="Compare"
+    description="Nodemailer, vendor SDKs, and orchestration platforms."
+    href="/docs/guides/compare"
+  />
+</Cards>

package/site/content/docs/get-started/non-goals.mdx

@@ -0,0 +1,57 @@
+---
+title: Non-goals
+description: What sently intentionally does not ship — and what belongs on top.
+icon: Ban
+source: "README.md"
+---
+
+sently is a **channel-delivery library**. Keeping the surface focused is part of the 1.x promise.
+
+<Callout title="The one rule">
+  Do not expect dashboards, preference centers, digests, or workflow builders inside sently. Put that product logic — or Novu / Knock / Courier — on top of the delivery layer.
+</Callout>
+
+## Out of scope
+
+| Non-goal | Notes |
+| --- | --- |
+| Orchestration platforms | Preference centers, digests, journey builders, in-app inboxes |
+| Hosted SaaS / per-send billing | MIT library in your process |
+| APNs as a native push transport | Use FCM and/or Web Push for 1.x |
+| Voice channels | Not a sently channel |
+| Inbound email productization | Outbound + webhook parsers only |
+| Nodemailer SOCKS / iCal parity | Intentionally omitted |
+| Equal support for every export | See [Support matrix](./support-matrix) |
+| Cross-channel preview / idempotency | Email-only today |
+
+## Complementary stack
+
+| Need | Place it… |
+| --- | --- |
+| Send email / SMS / WhatsApp / push | sently channel senders |
+| Swap providers without rewriting call sites | sently transports |
+| Preferences, digests, workflows, in-app | Your app or Novu / Knock / Courier **on top of** sently |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Will sently add a preference center?">
+    No. That is platform territory and conflicts with the library-not-platform position.
+  </Accordion>
+  <Accordion title="Where should I read the positioning story?">
+    See [Compare](/docs/guides/compare).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Compare](/docs/guides/compare)
+- [Support matrix](./support-matrix)
+- [Stability policy](./stability)
+
+## Next
+
+<Cards>
+  <Card title="Compare" href="/docs/guides/compare" />
+  <Card title="Introduction" href="/docs/get-started/introduction" />
+</Cards>

package/site/content/docs/get-started/stability.mdx

@@ -0,0 +1,69 @@
+---
+title: Stability policy
+description: What is frozen at 1.0 and what may grow under semver.
+icon: Shield
+source: "package.json"
+---
+
+From **1.0.0**, sently follows semver for the public channel-delivery surface.
+Apps should depend on channel senders and contracts — not on vendor SDK shapes.
+
+<Callout title="The one rule">
+  Treat channel factories, transport contracts, hooks, `SentlyError` codes, and
+  published subpath entrypoints as stable. New transports and optional fields may
+  appear in minor releases; renames or narrowed types require a major.
+</Callout>
+
+## Frozen at 1.x (Tier A)
+
+| Surface | Stable APIs |
+| --- | --- |
+| Factories | `createMailer`, `createSMTPMailer`, `createSmsSender`, `createWhatsAppSender`, `createPushSender` |
+| Contracts | `Transport`, `SmsTransport`, `WhatsAppTransport`, `PushTransport` option and result shapes |
+| Shared | Lifecycle hooks, `SentlyError` / `sentlyCode`, `ChannelSendResult` / `toChannelSendResult` |
+| Decorators | `RetryTransport`, `FallbackTransport` on all channels |
+| Email-only decorators | `IdempotencyTransport`, `PreviewTransport` (documented as email-only; not removed) |
+| Entrypoints | Subpaths listed in `package.json` `exports` — no silent moves |
+
+## Intentional shapes (stable, not transitional)
+
+| Shape | Meaning |
+| --- | --- |
+| `PushOptions` | Discriminated union: Web Push `subscription` **or** FCM `token` |
+| `providerIndex` | Optional on send results when a fallback decorator handled the send |
+| Email-only preview / idempotency | Stay email-scoped; not a signal they will move to other channels soon |
+
+## Allowed without a major
+
+- New transport classes and webhook parsers
+- New optional fields on options/results
+- New subpath exports
+- Bug fixes and security patches on the current **1.x** line
+
+## Security patches
+
+See [`SECURITY.md`](https://github.com/alialnaghmoush/sently/blob/main/SECURITY.md) for reporting and which versions receive patches.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Can I pin 0.x in production after 1.0?">
+    Prefer upgrading to 1.x. Pre-1.0 may still receive best-effort fixes but is not the supported security line.
+  </Accordion>
+  <Accordion title="Where is the production support promise?">
+    See [Support matrix](./support-matrix) for Supported vs Available transports.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Support matrix](./support-matrix)
+- [Non-goals](./non-goals)
+- [Compare](/docs/guides/compare)
+
+## Next
+
+<Cards>
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
+  <Card title="Non-goals" href="/docs/get-started/non-goals" />
+</Cards>