sently 0.10.0 → 1.0.0

package/site/content/docs/guides/failover.mdx

@@ -0,0 +1,121 @@
+---
+title: Failover
+description: Retry inside a provider, then fail over across providers on any channel.
+icon: GitBranch
+source: "src/transports/fallback.ts"
+---
+
+When a provider blips, retry that transport first, then fail over to the next.
+The same decorator pattern works for email, SMS, WhatsApp, and push.
+
+<Callout title="The one rule">
+  Wrap each provider in `RetryTransport`, then pass the list to `FallbackTransport`. Use the channel sender that matches the transport contract.
+</Callout>
+
+## Quick start
+
+<Steps>
+  <Step title="Email — Resend then SES">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { FallbackTransport } from "sently/transports/fallback";
+import { RetryTransport } from "sently/transports/retry";
+import { ResendTransport } from "sently/transports/resend";
+import { SESTransport } from "sently/transports/ses";
+
+const mailer = await createMailer({
+  transport: new FallbackTransport(
+    [
+      new RetryTransport(new ResendTransport({ apiKey: process.env.RESEND_API_KEY! })),
+      new RetryTransport(
+        new SESTransport({
+          region: process.env.AWS_REGION!,
+          accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
+          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
+        }),
+      ),
+    ],
+    { cooldownMs: 300_000 },
+  ),
+});
+```
+
+  </Step>
+  <Step title="SMS — Twilio then Unifonic">
+
+```ts
+import { createSmsSender } from "sently/sms";
+import { FallbackTransport } from "sently/transports/fallback";
+import { RetryTransport } from "sently/transports/retry";
+import { TwilioSmsTransport } from "sently/transports/twilio-sms";
+import { UnifonicTransport } from "sently/transports/unifonic";
+
+const sms = createSmsSender({
+  transport: new FallbackTransport(
+    [
+      new RetryTransport(
+        new TwilioSmsTransport({
+          accountSid: process.env.TWILIO_ACCOUNT_SID!,
+          authToken: process.env.TWILIO_AUTH_TOKEN!,
+        }),
+      ),
+      new RetryTransport(
+        new UnifonicTransport({
+          appSid: process.env.UNIFONIC_APPSID!,
+          senderId: "MyBrand",
+        }),
+      ),
+    ],
+    { cooldownMs: 300_000 },
+  ),
+});
+```
+
+  </Step>
+  <Step title="Inspect which provider won">
+
+```ts
+const result = await sms.send({
+  to: "+15551234567",
+  body: "Hello",
+  from: "+15557654321",
+});
+console.log(result.provider, result.providerIndex);
+```
+
+  </Step>
+</Steps>
+
+## Behavior
+
+| Behavior | Default |
+| --- | --- |
+| Fail over on 5xx / network | Yes |
+| Fail over on 400 / 401 / 403 | No (same client error on every provider) |
+| `cooldownMs` | Skip a failed provider until the cooldown ends |
+| Hooks | `onRetry` / `onFallback` on the channel sender when wired |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Why did both providers reject the same message?">
+    Permanent client errors do not fail over by default. Fix the payload or credentials before expecting a second provider to succeed.
+  </Accordion>
+  <Accordion title="Can I mix email and SMS in one FallbackTransport?">
+    No. Every entry must implement the same channel contract as the sender.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Retry](/docs/decorators/retry)
+- [Fallback](/docs/decorators/fallback)
+- [Support matrix](/docs/get-started/support-matrix)
+
+## Next
+
+<Cards>
+  <Card title="Fallback decorator" href="/docs/decorators/fallback" />
+  <Card title="Retry decorator" href="/docs/decorators/retry" />
+</Cards>

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

@@ -8,6 +8,8 @@ source: "README.md"
 Configure sently features around your delivery workflow.
 
 <Cards>
+  <Card title="Compare" href="/docs/guides/compare" />
+  <Card title="Failover" href="/docs/guides/failover" />
   <Card title="Adapters" href="/docs/guides/adapters" />
   <Card title="Webhooks" href="/docs/guides/webhooks" />
   <Card title="Security" href="/docs/guides/security" />

package/site/content/docs/guides/meta.json

@@ -3,6 +3,8 @@
   "icon": "Map",
   "pages": [
     "index",
+    "compare",
+    "failover",
     "adapters",
     "dkim",
     "oauth2",

package/site/content/docs/guides/security.mdx

@@ -1,17 +1,47 @@
 ---
 title: Security
-description: Protect credentials, delivery endpoints, and webhook integrity.
+description: Protect credentials, delivery endpoints, webhook integrity, and publish trust.
 icon: ShieldCheck
 source: "src/transports/webpush.ts"
 ---
 
-<Callout title="The one rule">Keep provider keys and VAPID private keys in a secrets manager or environment variables.</Callout>
+Provider API keys, VAPID private keys, and push endpoints are long-lived credentials.
+Keep them out of source control and out of unstructured logs.
 
-- Enable TLS for SMTP authentication; `requireTLS` defaults to true when auth is set.
-- Verify provider webhook signatures before parsing trusted events.
-- Do not log email bodies, SMS bodies, or full push subscription endpoints.
-- Treat a push endpoint as a delivery token.
+<Callout title="The one rule">
+  Keep provider keys and VAPID private keys in a secrets manager or environment variables.
+</Callout>
 
-<Accordions><Accordion title="Why is a push endpoint redacted in hooks?">Its path can contain a long-lived delivery token.</Accordion></Accordions>
+## Checklist
 
-<Cards><Card title="Webhooks" href="/docs/guides/webhooks" /></Cards>
+| Practice | Detail |
+| --- | --- |
+| SMTP TLS | `requireTLS` defaults to true when auth is set |
+| Webhooks | Verify signatures before trusting parsed events |
+| Logging | Do not log email/SMS bodies or full push endpoints |
+| Push | Treat subscription endpoints and FCM tokens as delivery tokens |
+| Reporting | Use private advisories — see root `SECURITY.md` |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Why is a push endpoint redacted in hooks?">
+    Its path can contain a long-lived delivery token. Hook context keeps a short fingerprint.
+  </Accordion>
+  <Accordion title="Where do I report a vulnerability?">
+    Open a private GitHub Security Advisory for this repository. Do not file a public issue. Details and response targets are in [`SECURITY.md`](https://github.com/alialnaghmoush/sently/blob/main/SECURITY.md).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Stability policy](/docs/get-started/stability)
+- [Webhooks](/docs/guides/webhooks)
+- [Web Push](/docs/transports/webpush)
+
+## Next
+
+<Cards>
+  <Card title="Webhooks" href="/docs/guides/webhooks" />
+  <Card title="Stability policy" href="/docs/get-started/stability" />
+</Cards>

package/site/content/docs/index.mdx

@@ -1,15 +1,89 @@
 ---
 title: sently handbook
-description: Channel-first messaging for email, SMS, WhatsApp, and push (Web Push / FCM).
+description: Channel-delivery for email, SMS, WhatsApp, and push — one sender shape as channels grow.
 icon: BookOpen
 source: "README.md"
 ---
 
-Use a channel sender in application code and put provider-specific configuration in a transport.
+sently is the channel-delivery layer for the order confirmation email, the OTP SMS, and the device push that follow.
+Apps call a channel sender; providers live in transports you can swap without rewriting send sites.
+
+<Callout title="The one rule">
+  Use `createMailer`, `createSmsSender`, `createWhatsAppSender`, or `createPushSender` in app code — never a vendor SDK as your application API.
+</Callout>
+
+## Quick start
+
+<Steps>
+  <Step title="Install">
+
+```bash
+bun add sently
+```
+
+  </Step>
+  <Step title="Send with a channel sender">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { ResendTransport } from "sently/transports/resend";
+
+const mailer = await createMailer({
+  transport: new ResendTransport({
+    apiKey: process.env.RESEND_API_KEY!,
+  }),
+});
+
+const result = await mailer.send({
+  from: "hello@example.com",
+  to: "person@example.com",
+  subject: "Welcome",
+  text: "Thanks for joining.",
+});
+console.log(result.messageId);
+```
+
+  </Step>
+</Steps>
+
+## Channels
+
+| Channel | Sender | Start here |
+| --- | --- | --- |
+| Email | `createMailer` / `createSMTPMailer` | [Email](/docs/channels/email) |
+| SMS | `createSmsSender` | [SMS](/docs/channels/sms) |
+| WhatsApp | `createWhatsAppSender` | [WhatsApp](/docs/channels/whatsapp) |
+| Push | `createPushSender` | [Push](/docs/channels/push) |
+
+Email factories are asynchronous. SMS, WhatsApp, and push factories return the sender synchronously; every `send` is async.
+
+## Where next
+
+| Path | When |
+| --- | --- |
+| [Get started](/docs/get-started) | Install, entrypoints, runtimes, migrate from Nodemailer |
+| [Channels](/docs/channels) | Full sender docs + lifecycle hooks |
+| [Transports](/docs/transports) | Provider list by channel |
+| [Failover](/docs/guides/failover) | Retry inside a provider, then fail over |
+| [Support matrix](/docs/get-started/support-matrix) | Supported vs Available for production |
+| [Compare](/docs/guides/compare) | vs vendor SDKs, Nodemailer, Novu / Knock / Courier |
+| [Stability](/docs/get-started/stability) | What is frozen at 1.x |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Is sently a notification platform like Novu or Knock?">
+    No. It is the delivery layer. Preference centers, digests, workflows, and in-app inboxes sit on top — custom code or those tools. See [Compare](/docs/guides/compare).
+  </Accordion>
+  <Accordion title="Where should I send first?">
+    Start with [Email](/docs/channels/email) or [Installation](/docs/get-started/installation), then open the channel page for SMS, WhatsApp, or push when you add that channel.
+  </Accordion>
+</Accordions>
+
+## Next
 
 <Cards>
   <Card title="Get started" href="/docs/get-started" />
-  <Card title="Quick start" href="/docs/quick-start" />
   <Card title="Channels" href="/docs/channels" />
-  <Card title="Transports" href="/docs/transports" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
 </Cards>

package/site/content/docs/meta.json

@@ -4,7 +4,6 @@
   "pages": [
     "index",
     "get-started",
-    "quick-start",
     "channels",
     "transports",
     "decorators",

package/site/content/docs/reference/exports.mdx

@@ -37,7 +37,7 @@ The main `sently` package is for shared types and factories — not every provid
 
 | Import | Use |
 | ------ | --- |
-| `sently/transports/<name>` | One provider or decorator (e.g. `sndr`, `unifonic`, `fcm`, `retry`) |
+| `sently/transports/<name>` | One provider or decorator (e.g. `sndr`, `mailpit`, `fcm`, `retry`) |
 
 HTTP providers such as SNDR, Resend, and Plunk are **not** re-exported from `sently`.
 
@@ -75,11 +75,14 @@ Provider transports live on `sently/transports/*` so bare Node/Deno imports of `
 ## Learn more
 
 - [Entrypoints](/docs/get-started/entrypoints) — which import to pick first
-- [Bundle size](/docs/guides/bundle-size) — measured stacks
+- [Stability policy](/docs/get-started/stability) — frozen entrypoints at 1.x
+- [Support matrix](/docs/get-started/support-matrix) — Supported vs Available
+- [Bundle size](/docs/guides/bundle-size) — measured stacks (supporting for Workers)
 
 ## Next
 
 <Cards>
   <Card title="Entrypoints" description="Choose a channel import path." href="/docs/get-started/entrypoints" />
+  <Card title="Support matrix" description="Production support promise." href="/docs/get-started/support-matrix" />
   <Card title="Transports" description="Provider list by channel." href="/docs/transports" />
 </Cards>

package/site/content/docs/reference/push-options.mdx

@@ -52,6 +52,20 @@ FCM stringifies non-string `data` values before send.
 
 Map any channel result with [channel send result](./channel-result).
 
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Can I send both subscription and token?">
+    No. Each call is either Web Push (`subscription`) or FCM (`token`). Match the shape to the transport.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Push channel](/docs/channels/push)
+- [Stability policy](/docs/get-started/stability) — union shape is frozen at 1.x
+- [Channel send result](./channel-result)
+
 ## Next
 
 <Cards>

package/site/content/docs/transports/fcm.mdx

@@ -1,11 +1,12 @@
 ---
 title: FCM
-description: Send mobile push through Firebase Cloud Messaging HTTP v1.
+description: Send mobile push through Firebase Cloud Messaging (current HTTP API).
 icon: Bell
 source: "src/transports/fcm.ts"
 ---
 
-Send device-token push through Firebase Cloud Messaging HTTP v1 for native Android and iOS clients.
+Send device-token push through Firebase Cloud Messaging for native Android and iOS clients.
+The transport uses the current FCM HTTP API with a service-account JWT — no Google SDK.
 Use [Web Push](./webpush) when you have a browser Push API subscription instead.
 
 <Callout title="The one rule">Pass `token` in push options — not a Web Push `subscription`.</Callout>
@@ -29,15 +30,18 @@ const push = createPushSender({
 ```
 
   </Step>
-  <Step title="Send to a device token">
+  <Step title="Verify credentials, then send">
 
 ```ts
+const check = await push.verify();
+console.log(check.ok, check.message);
+
 const result = await push.send({
   token: deviceRegistrationToken,
   title: "Hello",
   body: "World",
 });
-console.log(result.messageId, result.status);
+console.log(result.messageId, result.status, result.provider);
 ```
 
   </Step>

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

@@ -56,6 +56,7 @@ Every import below is an exported package subpath.
 | [Plunk](./plunk) | Email | `sently/transports/plunk` |
 | [SparkPost](./sparkpost) | Email | `sently/transports/sparkpost` |
 | [Mailtrap](./mailtrap) | Email | `sently/transports/mailtrap` |
+| [Mailpit](./mailpit) | Email (dev) | `sently/transports/mailpit` |
 | [Loops](./loops) | Email | `sently/transports/loops` |
 | [Cloudflare Email](./cloudflare-email) | Email | `sently/transports/cloudflare-email` |
 | [SNDR](./sndr) | Email | `sently/transports/sndr` |
@@ -87,13 +88,18 @@ For retry, fallback, preview, and idempotency wrappers, see [Decorators](../deco
     No. A transport implements one channel contract. Choose a transport listed for the channel sender you use.
   </Accordion>
   <Accordion title="How do I add retries or fallback?">
-    Wrap any channel transport with a [decorator](../decorators), then pass the wrapper to the matching sender.
+    Wrap any channel transport with a [decorator](../decorators), then pass the wrapper to the matching sender. See also the [failover guide](../guides/failover).
+  </Accordion>
+  <Accordion title="Is every exported transport equally Supported?">
+    No. See the [support matrix](../get-started/support-matrix) for Supported vs Available.
   </Accordion>
 </Accordions>
 
 ## Learn more
 
+- [Support matrix](../get-started/support-matrix)
 - [Decorators](../decorators)
+- [Failover](../guides/failover)
 - [Email channel](../channels/email)
 - [SMS channel](../channels/sms)
 - [Transport contracts](../reference/transport-contracts)
@@ -101,7 +107,7 @@ For retry, fallback, preview, and idempotency wrappers, see [Decorators](../deco
 ## Next
 
 <Cards>
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
   <Card title="Decorators" href="/docs/decorators" />
-  <Card title="Email channel" href="/docs/channels/email" />
-  <Card title="SMS channel" href="/docs/channels/sms" />
+  <Card title="Failover" href="/docs/guides/failover" />
 </Cards>

package/site/content/docs/transports/mailpit.mdx

@@ -0,0 +1,123 @@
+---
+title: Mailpit
+description: Catch outbound email in a local Mailpit instance during development.
+icon: Inbox
+source: "src/transports/mailpit.ts"
+---
+
+Catch outbound email in a local [Mailpit](https://github.com/axllent/mailpit) instance while you develop.
+Use it for the welcome email or password-reset flow before you point at a production provider.
+
+<Callout title="The one rule">
+  Use Mailpit only in development — swap to a production transport before you deploy.
+</Callout>
+
+## Quick start
+
+Start Mailpit (SMTP `1025`, UI `8025`):
+
+```sh
+docker run -d --rm -p 1025:1025 -p 8025:8025 axllent/mailpit
+```
+
+<Steps>
+  <Step title="Create the transport">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { MailpitTransport } from "sently/transports/mailpit";
+
+const mailpit = new MailpitTransport();
+const mailer = await createMailer({ transport: mailpit });
+```
+
+  </Step>
+  <Step title="Send through the mailer">
+
+```ts
+await mailer.send({
+  from: "dev@example.com",
+  to: "you@example.com",
+  subject: "Hello",
+  text: "Captured by Mailpit",
+});
+```
+
+  </Step>
+  <Step title="Inspect the inbox">
+
+Open `http://localhost:8025`, or list messages from code:
+
+```ts
+const inbox = await mailpit.messages();
+console.log(inbox.messages[0]?.Subject);
+```
+
+  </Step>
+</Steps>
+
+## Configuration
+
+| Option | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `host` | `string` | `"localhost"` | SMTP hostname |
+| `port` | `number` | `1025` | SMTP port |
+| `secure` | `boolean` | `false` | Implicit TLS on connect |
+| `requireTLS` | `boolean` | `false` | Refuse AUTH without TLS |
+| `auth` | `SMTPAuth` | — | Optional SMTP credentials |
+| `tls` | `TLSOptions` | — | TLS options when TLS is enabled |
+| `connectionTimeout` | `number` | — | Socket connect timeout (ms) |
+| `adapter` | `SocketAdapter` | auto-detected | Runtime TCP adapter |
+| `apiUrl` | `string` | `"http://localhost:8025"` | Web UI / REST API base |
+| `apiAuth` | `{ user, pass }` | — | Basic auth for the UI/API |
+
+`provider` is `"mailpit"`. `verify()` checks SMTP; `close()` closes the socket adapter.
+
+## REST helpers
+
+Vendor extras stay on the transport instance (not on `createMailer`):
+
+| Method | Mailpit API | Meaning |
+| --- | --- | --- |
+| `messages({ limit?, start? })` | `GET /api/v1/messages` | List captured messages (newest first) |
+| `getMessage(id)` | `GET /api/v1/message/{id}` | Full message body |
+| `deleteMessages(ids)` | `DELETE /api/v1/messages` | Delete by id |
+| `deleteAll()` | `DELETE` with empty `IDs` | Clear the inbox |
+| `webUrl` | — | UI base URL (same as `apiUrl`) |
+
+```ts
+await mailpit.deleteAll();
+await mailer.send({ from: "a@test.com", to: "b@test.com", subject: "T", text: "ok" });
+const list = await mailpit.messages({ limit: 1 });
+const full = await mailpit.getMessage(list.messages[0]!.ID);
+```
+
+REST failures throw `MailpitError` (`provider: "mailpit"`). Empty `getMessage("")` throws with status `400`.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Connection refused on port 1025">
+    Mailpit is not running, or the SMTP port is remapped. Start the container above, or set `host` / `port` to match your install.
+  </Accordion>
+  <Accordion title="API helpers fail but send works">
+    SMTP and the UI/API can bind to different hosts. Set `apiUrl` (and `apiAuth` if the UI requires Basic auth).
+  </Accordion>
+  <Accordion title="Should I use createSMTPMailer instead?">
+    Yes, if you only need SMTP. `MailpitTransport` adds local defaults and REST helpers for tests and inspection.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [SMTP](./smtp) — generic SMTP when you are not on Mailpit
+- [Preview](/docs/decorators/preview) — write `.eml` files to disk instead
+- [Email channel](/docs/channels/email) — `createMailer` contract
+
+## Next
+
+<Cards>
+  <Card title="Email channel" href="/docs/channels/email" />
+  <Card title="SMTP" href="/docs/transports/smtp" />
+  <Card title="Transports" href="/docs/transports" />
+</Cards>

package/site/content/docs/transports/meta.json

@@ -15,6 +15,7 @@
     "plunk",
     "sparkpost",
     "mailtrap",
+    "mailpit",
     "loops",
     "cloudflare-email",
     "sndr",

package/site/content/docs/transports/smtp.mdx

@@ -1,47 +1,86 @@
 ---
 title: SMTP
-description: Connect to an SMTP relay with an explicit transport.
+description: Connect to an SMTP relay with host, port, and auth.
 icon: Truck
 source: "src/transports/smtp.ts"
 ---
 
-Connect to an SMTP relay with an explicit transport.
+Connect to an SMTP relay for production or a local catcher.
+Prefer `createSMTPMailer` when your config starts with host and port — it picks a runtime adapter for you.
 
-<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+<Callout title="The one rule">
+  Use `createSMTPMailer` for host/port config; use `createMailer` only with an explicit `SMTPTransport` that already has an adapter.
+</Callout>
 
-## Configuration
-
-| Option | Type | Default or requirement |
-| --- | --- | --- |
-| `host` | `string` | required |
-| `port` | `number` | 587 or 465 based on secure |
-| `secure` | `boolean` | false |
-| `auth` | `SMTPAuth` | optional |
-| `requireTLS` | `boolean` | true when auth is set |
-| `adapter` | `SocketAdapter` | optional |
-| `pool` | `boolean` | false |
-| `dkim` | `DKIMConfig` | optional |
+## Quick start
 
 <Steps>
-  <Step title="Configure the transport">
+  <Step title="Create an SMTP mailer">
 
 ```ts
-import { createMailer } from "sently/mailer";
-import { SMTPTransport } from "sently/transports/smtp";
+import { createSMTPMailer } from "sently/smtp";
 
-const sender = createMailer({ transport: new SMTPTransport({ host: "smtp.example.com", auth: { user: "user@example.com", pass: "..." } }) });
+const mailer = await createSMTPMailer({
+  host: "smtp.example.com",
+  port: 587,
+  auth: { user: "you@example.com", pass: process.env.SMTP_PASSWORD! },
+});
 ```
 
   </Step>
   <Step title="Send with the channel API">
 
 ```ts
-await sender.send({ from: "hello@example.com", to: "person@example.com", subject: "Hello", text: "Hi" });
+await mailer.send({
+  from: "hello@example.com",
+  to: "person@example.com",
+  subject: "Hello",
+  text: "Hi",
+});
 ```
 
   </Step>
 </Steps>
 
-<Accordions><Accordion title="Should I call the provider SDK?">No. Use the sently sender; provider-specific extras stay on the transport instance.</Accordion></Accordions>
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `host` | `string` | required |
+| `port` | `number` | `587`, or `465` when `secure` |
+| `secure` | `boolean` | `false` |
+| `auth` | `SMTPAuth` | optional |
+| `requireTLS` | `boolean` | `true` when `auth` is set |
+| `adapter` | `SocketAdapter` | auto via `createSMTPMailer` |
+| `pool` | `boolean` | `false` |
+| `dkim` | `DKIMConfig` | optional |
+
+For local capture with defaults and REST helpers, use [Mailpit](./mailpit) instead of hand-wiring `localhost:1025`.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Should I call the provider SDK?">
+    No. Use the sently sender; provider-specific extras stay on the transport instance.
+  </Accordion>
+  <Accordion title="createMailer rejects host and port">
+    Pass an explicit transport, or use `createSMTPMailer` for relay configuration.
+  </Accordion>
+  <Accordion title="Local development without a real relay">
+    Use [Mailpit](./mailpit) (`sently/transports/mailpit`) or [Preview](/docs/decorators/preview).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Mailpit](./mailpit) — local SMTP catcher with inbox API
+- [Email channel](/docs/channels/email) — `createMailer` / `createSMTPMailer`
+- [Runtimes](/docs/get-started/runtimes) — socket adapters
+
+## 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="Transports" href="/docs/transports" />
+</Cards>