sently 0.8.0 → 0.9.0

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

@@ -0,0 +1,47 @@
+---
+title: SMTP
+description: Connect to an SMTP relay with an explicit transport.
+icon: Truck
+source: "src/transports/smtp.ts"
+---
+
+Connect to an SMTP relay with an explicit transport.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</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 |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { SMTPTransport } from "sently/transports/smtp";
+
+const sender = createMailer({ transport: new SMTPTransport({ host: "smtp.example.com", auth: { user: "user@example.com", pass: "..." } }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.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>
+
+<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>

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

@@ -0,0 +1,144 @@
+---
+title: SNDR
+description: Send transactional email through the SNDR HTTP API with createMailer.
+icon: Truck
+source: "src/transports/sndr.ts"
+---
+
+Use SNDR when you want an HTTP email API for receipts, sign-in mail, and other app-triggered messages.
+Wire `SndrTransport` into `createMailer` — do not call the vendor SDK from application code.
+
+<Callout title="The one rule">
+  Import from `sently/transports/sndr`, pass the transport to `await createMailer(...)`, and send
+  with the mailer — keep delivery on the email channel.
+</Callout>
+
+## Quick start
+
+<Steps>
+
+<Step>
+### Configure
+
+```ts
+import { createMailer } from "sently/mailer";
+import { SndrTransport } from "sently/transports/sndr";
+
+const mailer = await createMailer({
+  transport: new SndrTransport({
+    apiKey: process.env.SNDR_API_KEY!,
+  }),
+});
+```
+
+</Step>
+
+<Step>
+### Send
+
+```ts
+const result = await mailer.send({
+  from: "hello@yourdomain.com",
+  to: "customer@example.com",
+  subject: "Welcome aboard",
+  html: "<p>Thanks for joining us.</p>",
+});
+```
+
+</Step>
+
+<Step>
+### See the result
+
+```ts
+console.log(result.messageId); // e.g. em_…
+console.log(result.response); // e.g. queued
+```
+
+`from` must use a domain verified in the SNDR dashboard.
+
+</Step>
+
+</Steps>
+
+## Configuration
+
+| Option | Type | Default | Meaning |
+| ------ | ---- | ------- | ------- |
+| `apiKey` | `string` | required | Bearer key (`sndr_live_…` / `sndr_test_…`). |
+| `baseUrl` | `string` | `https://api.sndr.sh` | API origin (no trailing slash needed). |
+| `defaultTemplateId` | `string` | — | Default SNDR `template_id` when not set per message. |
+
+## Message mapping
+
+| Mail option | SNDR field | Notes |
+| ----------- | ---------- | ----- |
+| `from` | `from` | MIME form `Name <addr>` when a display name is present. |
+| `to` / `cc` / `bcc` | `to` / `cc` / `bcc` | Arrays of email addresses. |
+| `replyTo` | `reply_to` | First address only. |
+| `subject` | `subject` | Required. |
+| `html` / `text` | `html` / `text` | Optional body fields. |
+| `headers` | `headers` | Custom headers; template header is stripped. |
+| `idempotencyKey` / `messageId` | `Idempotency-Key` | Sent when present. |
+| `data` | `variables` | Only when a template id is set. |
+
+## Templates
+
+Set a template with the `x-sndr-template-id` header (or `defaultTemplateId` on the transport).
+Pass template variables through `data`.
+
+```ts
+import { SNDR_TEMPLATE_ID_HEADER } from "sently/transports/sndr";
+
+await mailer.send({
+  from: "hello@yourdomain.com",
+  to: "customer@example.com",
+  subject: "Welcome",
+  headers: { [SNDR_TEMPLATE_ID_HEADER]: "tpl_welcome" },
+  data: { name: "Ada" },
+});
+```
+
+## Verify and errors
+
+`verify()` calls `GET /v1/domains` with the same Bearer key.
+
+Failed HTTP responses throw `SndrError` (`SentlyError`) with the API `error.message` when present.
+
+## Troubleshooting
+
+<Accordions>
+
+<Accordion title="from domain is not verified">
+
+SNDR rejects sends from unverified domains. Verify DNS in the SNDR dashboard, then retry with that domain in `from`.
+
+</Accordion>
+
+<Accordion title="Should I import SndrTransport from sently?">
+
+No. Use `sently/transports/sndr`. The main `sently` package does not re-export HTTP provider transports.
+
+</Accordion>
+
+<Accordion title="Should I call the @rkiza/sndr SDK?">
+
+No. Use `createMailer` plus `SndrTransport`. Keep vendor extras off the shared email contract.
+
+</Accordion>
+
+</Accordions>
+
+## Learn more
+
+- [Email channel](/docs/channels/email) — mailer options and send pipeline
+- [Webhooks](/docs/guides/webhooks) — SNDR delivery events and signature verification
+- [Bundle size](/docs/guides/bundle-size) — why subpath imports stay small
+
+## Next
+
+<Cards>
+  <Card title="Email channel" description="createMailer and MailOptions." href="/docs/channels/email" />
+  <Card title="Webhooks" description="Parse and verify SNDR events." href="/docs/guides/webhooks" />
+  <Card title="Transports" description="All provider transports by channel." href="/docs/transports" />
+</Cards>

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

@@ -0,0 +1,41 @@
+---
+title: SparkPost
+description: Send email through the SparkPost transmissions API.
+icon: Truck
+source: "src/transports/sparkpost.ts"
+---
+
+Send email through the SparkPost transmissions API.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `apiKey` | `string` | required |
+| `euRegion` | `boolean` | false |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { SparkPostTransport } from "sently/transports/sparkpost";
+
+const sender = createMailer({ transport: new SparkPostTransport({ apiKey: process.env.SPARKPOST_API_KEY! }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.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>
+
+<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>

package/site/content/docs/transports/taqnyat-mail.mdx

@@ -0,0 +1,41 @@
+---
+title: Taqnyat Mail
+description: Send email through the Taqnyat Email API.
+icon: Truck
+source: "src/transports/taqnyat-mail.ts"
+---
+
+Send email through the Taqnyat Email API.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `bearerToken` | `string` | required |
+| `campaignName` | `string` | required |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createMailer } from "sently/mailer";
+import { TaqnyatMailTransport } from "sently/transports/taqnyat-mail";
+
+const sender = createMailer({ transport: new TaqnyatMailTransport({ bearerToken: process.env.TAQNYAT_MAIL_TOKEN!, campaignName: "transactional" }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.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>
+
+<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>

package/site/content/docs/transports/taqnyat-sms.mdx

@@ -0,0 +1,41 @@
+---
+title: Taqnyat SMS
+description: Send SMS through the Taqnyat API.
+icon: Truck
+source: "src/transports/taqnyat-sms.ts"
+---
+
+Send SMS through the Taqnyat API.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `bearerToken` | `string` | required |
+| `sender` | `string` | required |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createSmsSender } from "sently/sms";
+import { TaqnyatSmsTransport } from "sently/transports/taqnyat-sms";
+
+const sender = createSmsSender({ transport: new TaqnyatSmsTransport({ bearerToken: "...", sender: "MyBrand" }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.send({ to: "+15551234567", body: "Hello" });
+```
+
+  </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>
+
+<Cards><Card title="Sms channel" href="/docs/channels/sms" /></Cards>

package/site/content/docs/transports/taqnyat-whatsapp.mdx

@@ -0,0 +1,40 @@
+---
+title: Taqnyat WhatsApp
+description: Send WhatsApp templates and session text through Taqnyat.
+icon: Truck
+source: "src/transports/taqnyat-whatsapp.ts"
+---
+
+Send WhatsApp templates and session text through Taqnyat.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `bearerToken` | `string` | required |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createWhatsAppSender } from "sently/whatsapp";
+import { TaqnyatWhatsAppTransport } from "sently/transports/taqnyat-whatsapp";
+
+const sender = createWhatsAppSender({ transport: new TaqnyatWhatsAppTransport({ bearerToken: "..." }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.send({ to: "15551234567", template: { name: "welcome", language: "en_US" } });
+```
+
+  </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>
+
+<Cards><Card title="Whatsapp channel" href="/docs/channels/whatsapp" /></Cards>

package/site/content/docs/transports/twilio-sms.mdx

@@ -0,0 +1,128 @@
+---
+title: Twilio SMS
+description: Send SMS through the Twilio Messages API with createSmsSender.
+icon: Truck
+source: "src/transports/twilio-sms.ts"
+---
+
+Use Twilio when your SMS traffic should go through the Programmable Messaging Messages API.
+Wire `TwilioSmsTransport` into `createSmsSender` — Verify, Voice, and other Twilio products stay off this transport.
+
+<Callout title="The one rule">
+  Provide `From` **or** `messagingServiceSid` (or both), keep E.164 `+` prefixes, and send only
+  through `createSmsSender`.
+</Callout>
+
+## Quick start
+
+<Steps>
+
+<Step>
+### Configure
+
+```ts
+import { createSmsSender } from "sently/sms";
+import { TwilioSmsTransport } from "sently/transports/twilio-sms";
+
+const sms = createSmsSender({
+  transport: new TwilioSmsTransport({
+    accountSid: process.env.TWILIO_ACCOUNT_SID!,
+    apiKey: process.env.TWILIO_API_KEY!,
+    authToken: process.env.TWILIO_API_KEY_SECRET!,
+    from: "+15557654321",
+  }),
+});
+```
+
+Production auth: API Key SID as Basic username and API Key Secret as password, with Account SID still in the URL path.
+For local testing you may omit `apiKey` and use Account SID + Auth Token.
+
+</Step>
+
+<Step>
+### Send
+
+```ts
+const result = await sms.send({
+  to: "+15551234567",
+  body: "Your code is 123456",
+});
+```
+
+</Step>
+
+<Step>
+### See the result
+
+```ts
+console.log(result.messageId); // SM…
+console.log(result.status); // e.g. queued
+```
+
+</Step>
+
+</Steps>
+
+## Configuration
+
+| Option | Type | Default | Meaning |
+| ------ | ---- | ------- | ------- |
+| `accountSid` | `string` | required | Account SID in the Messages URL path. |
+| `authToken` | `string` | required | Auth Token, or API Key Secret when `apiKey` is set. |
+| `apiKey` | `string` | — | API Key SID used as Basic-auth username (recommended in production). |
+| `from` | `string` | — | Default From number / sender id. |
+| `messagingServiceSid` | `string` | — | Messaging Service SID (`MG…`) as sender alternative. |
+| `statusCallback` | `string` | — | Delivery status callback URL. |
+
+Either `from` / `options.from` or `messagingServiceSid` is required for each send.
+
+## Messaging Service
+
+When `messagingServiceSid` is set and `From` is omitted, Twilio picks a sender from the service pool.
+You may set both to pin a specific From inside that pool.
+
+```ts
+const sms = createSmsSender({
+  transport: new TwilioSmsTransport({
+    accountSid: process.env.TWILIO_ACCOUNT_SID!,
+    authToken: process.env.TWILIO_AUTH_TOKEN!,
+    messagingServiceSid: "MG…",
+  }),
+});
+```
+
+## Verify and errors
+
+`verify()` fetches `GET /2010-04-01/Accounts/{AccountSid}.json` with the same Basic credentials.
+
+Failed Messages responses throw `TwilioSmsError` with Twilio’s `message` / `code` payload when present.
+
+## Troubleshooting
+
+<Accordions>
+
+<Accordion title="Twilio SMS requires From or MessagingServiceSid">
+
+Set `from` on the transport or per send, or configure `messagingServiceSid`.
+
+</Accordion>
+
+<Accordion title="Invalid To phone number">
+
+Twilio expects E.164 with a leading `+`. Do not strip `+` the way some regional SMS APIs require.
+
+</Accordion>
+
+</Accordions>
+
+## Learn more
+
+- [SMS channel](/docs/channels/sms) — `createSmsSender` and hooks
+- [Transports](/docs/transports) — other SMS providers
+
+## Next
+
+<Cards>
+  <Card title="SMS channel" description="createSmsSender options." href="/docs/channels/sms" />
+  <Card title="Transports" description="Providers by channel." href="/docs/transports" />
+</Cards>

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

@@ -0,0 +1,43 @@
+---
+title: Web Push
+description: Encrypt and send browser notifications with VAPID.
+icon: Truck
+source: "src/transports/webpush.ts"
+---
+
+Encrypt and send browser notifications with VAPID.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `vapidPublicKey` | `string` | required |
+| `vapidPrivateKey` | `string` | required |
+| `subject` | `string` | required |
+| `allowedEndpointHosts` | `string[]` | optional |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createPushSender } from "sently/push";
+import { WebPushTransport } from "sently/transports/webpush";
+
+const sender = createPushSender({ transport: new WebPushTransport({ vapidPublicKey: "...", vapidPrivateKey: "...", subject: "mailto:you@example.com" }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.send({ subscription, title: "Hello", body: "World" });
+```
+
+  </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>
+
+<Cards><Card title="Push channel" href="/docs/channels/push" /></Cards>

package/site/content/docs/transports/whatsapp-cloud.mdx

@@ -0,0 +1,42 @@
+---
+title: WhatsApp Cloud
+description: Send WhatsApp templates and session text through Meta Cloud API.
+icon: Truck
+source: "src/transports/whatsapp-cloud.ts"
+---
+
+Send WhatsApp templates and session text through Meta Cloud API.
+
+<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>
+
+## Configuration
+
+| Option | Type | Default or requirement |
+| --- | --- | --- |
+| `accessToken` | `string` | required |
+| `phoneNumberId` | `string` | required |
+| `apiVersion` | `string` | v26.0 |
+
+<Steps>
+  <Step title="Configure the transport">
+
+```ts
+import { createWhatsAppSender } from "sently/whatsapp";
+import { WhatsAppCloudTransport } from "sently/transports/whatsapp-cloud";
+
+const sender = createWhatsAppSender({ transport: new WhatsAppCloudTransport({ accessToken: "...", phoneNumberId: "..." }) });
+```
+
+  </Step>
+  <Step title="Send with the channel API">
+
+```ts
+await sender.send({ to: "15551234567", template: { name: "welcome", language: "en_US" } });
+```
+
+  </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>
+
+<Cards><Card title="Whatsapp channel" href="/docs/channels/whatsapp" /></Cards>

package/dist/chunk-5scdgffb.js

@@ -1,5 +0,0 @@
-var J=new TextEncoder;function P(k){let f=typeof k==="string"?J.encode(k):k,j="",A=0;while(A<f.length){let m=f[A]??0,q=f[A+1],z=f[A+2];if(q===void 0){j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[m>>2],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[(m&3)<<4],j+="==";break}if(z===void 0){j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[m>>2],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[(m&3)<<4|q>>4],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[(q&15)<<2],j+="=";break}j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[m>>2],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[(m&3)<<4|q>>4],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[(q&15)<<2|z>>6],j+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"[z&63],A+=3}return R(j)}function S(k){let f=k.replace(/\s/g,""),j=f.length;if(j===0)return new Uint8Array(0);if(j%4!==0)throw Error("Invalid base64 string length");let A=f.endsWith("==")?2:f.endsWith("=")?1:0,m=j*3/4-A,q=new Uint8Array(m),z=0;for(let D=0;D<j;D+=4){let K=G(f[D]??"="),M=G(f[D+1]??"="),N=G(f[D+2]??"="),O=G(f[D+3]??"="),H=K<<18|M<<12|N<<6|O;if(z<m)q[z++]=H>>16&255;if(z<m)q[z++]=H>>8&255;if(z<m)q[z++]=H&255}return q}function W(k){if(!Q(k))return k;return`=?UTF-8?B?${P(k).replace(/\r\n/g,"")}?=`}function Q(k){for(let f=0;f<k.length;f++)if(k.charCodeAt(f)>127)return!0;return!1}function G(k){if(k==="=")return 0;let f="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".indexOf(k);if(f===-1)throw Error(`Invalid base64 character: ${k}`);return f}function R(k){let f=[];for(let j=0;j<k.length;j+=76)f.push(k.slice(j,j+76));return f.join(`\r
-`)}function X(k){return J.encode(k)}
-export{P as T,S as U,W as V,X as W};
-
-//# debugId=4A06DB0A7917D84164756E2164756E21

package/dist/chunk-8phpsns1.js

@@ -1,13 +0,0 @@
-import{T as O,U as K,W as H}from"./chunk-5scdgffb.js";import{X as v,Z as B}from"./chunk-6bkj4y4r.js";var j=64;function X(q){return q>>>0}function U(q){let z=g(q),G=1732584193,Q=4023233417,N=2562383102,J=271733878;for(let F=0;F<z.length;F+=64){let $=z.subarray(F,F+64),w=new Uint32Array(16);for(let W=0;W<16;W++){let A=W*4;w[W]=X(($[A]??0)|($[A+1]??0)<<8|($[A+2]??0)<<16|($[A+3]??0)<<24)}let x=G,D=Q,I=N,R=J;for(let W=0;W<64;W++){let A,_;if(W<16)A=X(D&I|~D&R),_=W;else if(W<32)A=X(D&R|I&~R),_=X((5*W+1)%16);else if(W<48)A=X(D^I^R),_=X((3*W+5)%16);else A=X(I^(D|~R)),_=X(7*W%16);let y=R;R=I,I=D,D=X(D+T(X(x+A+X((P[W]??0)+(w[_]??0))),L[W]??0)),x=y}G=X(G+x),Q=X(Q+D),N=X(N+I),J=X(J+R)}let Y=new Uint8Array(16),V=new DataView(Y.buffer);return V.setUint32(0,G,!0),V.setUint32(4,Q,!0),V.setUint32(8,N,!0),V.setUint32(12,J,!0),Y}var L=[7,12,17,22,7,12,17,22,7,12,17,22,7,12,17,22,5,9,14,20,5,9,14,20,5,9,14,20,5,9,14,20,4,11,16,23,4,11,16,23,4,11,16,23,4,11,16,23,6,10,15,21,6,10,15,21,6,10,15,21,6,10,15,21],P=new Uint32Array([3614090360,3905402710,606105819,3250441966,4118548399,1200080426,2821735955,4249261313,1770035416,2336552879,4294925233,2304563134,1804603682,4254626195,2792965006,1236535329,4129170786,3225465664,643717713,3921069994,3593408605,38016083,3634488961,3889429448,568446438,3275163606,4107603335,1163531501,2850285829,4243563512,1735328473,2368359562,4294588738,2272392833,1839030562,4259657740,2763975236,1272893353,4139469664,3200236656,681279174,3936430074,3572445317,76029189,3654602809,3873151461,530742520,3299628645,4096336452,1126891415,2878612391,4237533241,1700485571,2399980690,4293915773,2240044497,1873313359,4264355552,2734768916,1309151649,4149444226,3174756917,718787259,3951481745]);function T(q,z){return X(q<<z|q>>>32-z)}function g(q){let z=q.length*8,G=(56-(q.length+1)%64+64)%64,Q=q.length+1+G+8,N=new Uint8Array(Q);N.set(q),N[q.length]=128;let J=new DataView(N.buffer);return J.setUint32(Q-8,z>>>0,!0),J.setUint32(Q-4,Math.floor(z/4294967296),!0),N}function C(q,z){let G=q;if(G.length>j)G=U(G);let Q=new Uint8Array(j);Q.set(G);let N=new Uint8Array(j),J=new Uint8Array(j);for(let $=0;$<j;$++)N[$]=(Q[$]??0)^54,J[$]=(Q[$]??0)^92;let Y=new Uint8Array(N.length+z.length);Y.set(N),Y.set(z,N.length);let V=U(Y),F=new Uint8Array(J.length+V.length);return F.set(J),F.set(V,J.length),U(F)}function E(q){return Array.from(q,(z)=>z.toString(16).padStart(2,"0")).join("")}async function M(q,z,G){let Q=K(q.trim()),N=H(G),J=C(N,Q),Y=E(J);return O(`${z} ${Y}`).replace(/\r\n/g,"")}class Z extends v{command;response;constructor(q,z,G,Q){super(q,B(z,G),{provider:"smtp"});this.command=G;this.response=Q;this.name="SMTPError",this.code=z}}function u(q){let z;switch(q.type){case"EHLO":{z=`EHLO ${q.domain.replace(/[\r\n]/g,"")}`;break}case"STARTTLS":z="STARTTLS";break;case"AUTH_LOGIN":z="AUTH LOGIN";break;case"AUTH_PLAIN":z=`AUTH PLAIN ${O(`\x00${q.user}\x00${q.pass}`).replace(/\r\n/g,"")}`;break;case"AUTH_CRAM_MD5_INIT":z="AUTH CRAM-MD5";break;case"AUTH_CRAM_MD5_RESPONSE":return H(`${q.response}\r
-`);case"AUTH_XOAUTH2":z=`AUTH XOAUTH2 ${q.xoauth2String}`;break;case"MAIL_FROM":if(/[\r\n]/.test(q.address))throw new Z("Invalid address: contains CRLF",0,"MAIL FROM",q.address);z=`MAIL FROM:<${q.address}>`;break;case"RCPT_TO":if(/[\r\n]/.test(q.address))throw new Z("Invalid address: contains CRLF",0,"RCPT TO",q.address);z=`RCPT TO:<${q.address}>`;break;case"DATA":z="DATA";break;case"DATA_BODY":return H(S(q.content));case"QUIT":z="QUIT";break;case"RSET":z="RSET";break;case"NOOP":z="NOOP";break}return H(`${z}\r
-`)}function l(q){let z=new TextDecoder().decode(q).trim(),G=z.split(/\r?\n/),N=(G[G.length-1]??"").match(/^(\d{3})([\s-])(.*)$/);if(!N)throw new Z("Invalid SMTP response",0,"PARSE",z);let J=Number.parseInt(N[1]??"0",10),Y=G.map((V)=>V.replace(/^\d{3}[\s-]/,"")).join(" ");return{code:J,message:Y,isSuccess:J>=200&&J<300,isReady:J>=300&&J<400,isError:J>=400}}function p(q){if(q.length===0)return null;let z=q.reduce((V,F)=>V+F.length,0),G=new Uint8Array(z),Q=0;for(let V of q)G.set(V,Q),Q+=V.length;let J=new TextDecoder().decode(G).split(/\r?\n/).filter((V)=>V.length>0);if(J.length===0)return null;let Y=J[J.length-1]??"";if(/^\d{3} /.test(Y))return G;return null}function m(q){let z=q.map((G)=>G.toUpperCase());if(z.some((G)=>G.includes("AUTH")&&G.includes("XOAUTH2")))return"OAUTH2";if(z.some((G)=>G.includes("AUTH")&&G.includes("CRAM-MD5")))return"CRAM-MD5";if(z.some((G)=>G.includes("AUTH")&&G.includes("LOGIN")))return"LOGIN";if(z.some((G)=>G.includes("AUTH")&&G.includes("PLAIN")))return"PLAIN";throw new Z("No supported AUTH method",0,"EHLO",q.join(" "))}function i(q){return q.message.split(/\s+/).flatMap((z)=>z.split(/\r?\n/)).filter(Boolean)}function r(q,z,G){if(!z.includes(q.code))throw new Z(`Unexpected SMTP response for ${G}`,q.code,G,q.message)}function S(q){return`${new TextDecoder().decode(q).split(/\r?\n/).map((N)=>N.startsWith(".")?`.${N}`:N).join(`\r
-`)}\r
-.\r
-`}function t(q){return H(`${O(q).replace(/\r\n/g,"")}\r
-`)}function o(q){return H(`${O(q).replace(/\r\n/g,"")}\r
-`)}function n(q){return H(`${q}\r
-`)}function s(q){return H(`${q}\r
-`)}
-export{M as H,Z as I,u as J,l as K,p as L,m as M,i as N,r as O,t as P,o as Q,n as R,s as S};
-
-//# debugId=B24DD712C817A87F64756E2164756E21

package/dist/chunk-m07smapm.js

@@ -1,3 +0,0 @@
-import{s as U}from"./chunk-wbvhaqcp.js";import{u as X}from"./chunk-zst8an2p.js";import{v as b}from"./chunk-vhxzhx8b.js";import{H as k,I as $,J as Z,K as O,L as q,M as L,N as v,O as N,P as A,Q as j,S as E}from"./chunk-8phpsns1.js";import{_ as C}from"./chunk-nbmq8ejv.js";class T{provider="smtp";config;adapter=null;constructor(z){this.config=P(z)}async send(z){let B={...z,attachments:await b(z.attachments)},G=await X(B,this.config.dkim),F=await this.getAdapter(),W=this.config.direct?await M(G.envelope.from.split("@")[1]??this.config.host):this.config.host;await F.connect(W,this.config.port),this.adapter=F;try{return await D(F,this.config),await S(F,G)}finally{await H(F),this.adapter=null}}async verify(){try{let z=await this.getAdapter();await z.connect(this.config.host,this.config.port);try{return await D(z,this.config),{ok:!0,provider:"smtp"}}finally{await H(z)}}catch(z){return{ok:!1,provider:"smtp",message:z instanceof Error?z.message:String(z)}}}async close(){if(this.adapter)await this.adapter.close(),this.adapter=null}async getAdapter(){if(!this.config.adapter)throw new $("No socket adapter configured",0,"CONNECT","");return this.config.adapter}}function P(z){let B=z.secure??!1;return{host:z.host,port:z.port??(B?465:587),secure:B,...z.auth!==void 0?{auth:z.auth}:{},...z.requireTLS!==void 0?{requireTLS:z.requireTLS}:{},...z.dkim!==void 0?{dkim:z.dkim}:{},...z.tls!==void 0?{tls:z.tls}:{},...z.connectionTimeout!==void 0?{connectionTimeout:z.connectionTimeout}:{},...z.greetingTimeout!==void 0?{greetingTimeout:z.greetingTimeout}:{},...z.socketTimeout!==void 0?{socketTimeout:z.socketTimeout}:{},...z.direct!==void 0?{direct:z.direct}:{},...z.adapter!==void 0?{adapter:z.adapter}:{}}}async function D(z,B){let G=await J(z);N(G,[220],"greeting");let F=await I(z,B.host),W=F.some((Q)=>Q.toUpperCase()==="STARTTLS");if(!B.secure&&!z.secure&&W){await Y(z,Z({type:"STARTTLS"}));let Q=await J(z);N(Q,[220],"STARTTLS"),await z.startTLS(B.tls),F=await I(z,B.host)}if(B.auth){let Q=B.requireTLS??!0,V=z.secure||B.secure;if(Q&&!V)throw new $("Refusing to authenticate over unencrypted connection. Set requireTLS: false to disable this check (not recommended).",0,"AUTH","");await l(z,B.auth,F)}}async function S(z,B){await _(z,{type:"MAIL_FROM",address:B.envelope.from});let G=await J(z);N(G,[250],"MAIL FROM");let F=[],W=[];for(let K of B.envelope.to)if(await Y(z,Z({type:"RCPT_TO",address:K})),(await J(z)).isSuccess)F.push(K);else W.push(K);await _(z,{type:"DATA"});let Q=await J(z);N(Q,[354],"DATA");let V;try{await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z)}catch(K){if(await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z),V.isError)throw K}return N(V,[250],"DATA end"),{messageId:B.messageId,accepted:F,rejected:W,response:V.message,envelope:B.envelope}}async function H(z){try{await _(z,{type:"QUIT"}),await J(z)}catch{}finally{await z.close()}}async function I(z,B){await _(z,{type:"EHLO",domain:B});let G=await J(z);return N(G,[250],"EHLO"),v(G)}async function l(z,B,G){if(B.type==="OAUTH2"&&B.oauth2){let K=await new U(B.oauth2).buildXOAUTH2();await _(z,{type:"AUTH_XOAUTH2",xoauth2String:K});let x=await J(z);if(x.code===334)await Y(z,E("")),x=await J(z);N(x,[235],"AUTH XOAUTH2");return}let F=B.type??L(G);if(F==="CRAM-MD5"){let V=y(B,"CRAM-MD5");await _(z,{type:"AUTH_CRAM_MD5_INIT"});let K=await J(z);N(K,[334],"AUTH CRAM-MD5");let x=K.message.trim(),w=await k(x,B.user,V);await _(z,{type:"AUTH_CRAM_MD5_RESPONSE",response:w}),K=await J(z),N(K,[235],"AUTH CRAM-MD5 response");return}if(F==="PLAIN"){let V=y(B,"PLAIN");await Y(z,Z({type:"AUTH_PLAIN",user:B.user,pass:V}));let K=await J(z);N(K,[235],"AUTH PLAIN");return}let W=y(B,"LOGIN");await Y(z,Z({type:"AUTH_LOGIN",user:B.user,pass:W}));let Q=await J(z);N(Q,[334],"AUTH LOGIN"),await Y(z,j(B.user)),Q=await J(z),N(Q,[334],"AUTH LOGIN user"),await Y(z,A(W)),Q=await J(z),N(Q,[235],"AUTH LOGIN pass")}function y(z,B){if(!z.pass)throw new $(`Password required for ${B} authentication`,0,`AUTH ${B}`,"");return z.pass}async function _(z,B){await Y(z,Z(B))}async function Y(z,B){await z.write(B)}async function J(z){let B=[];for await(let G of z.read()){B.push(G);let F=q(B);if(F)return O(F)}throw new $("Connection closed while reading SMTP response",0,"READ","")}async function M(z){let G=await(await import("node:dns/promises")).resolveMx(z);if(G.length===0)throw new $(`No MX records for ${z}`,0,"MX","");return G.sort((F,W)=>F.priority-W.priority),G[0]?.exchange??z}export{T as k,P as l,D as m,S as n,H as o,J as p};
-
-//# debugId=27963FE5C2BAA8F464756E2164756E21

package/dist/chunk-n5dan5bz.js

@@ -1,4 +0,0 @@
-import{A as J}from"./chunk-9zkv5azm.js";import{X as Q}from"./chunk-6bkj4y4r.js";class K extends Error{attempts;constructor(w){super(`All ${w.length} transports failed`);this.name="FallbackError",this.attempts=w}}var X=J;function T(w){if(w instanceof Q&&w.sentlyCode==="SMTP_AUTH_FAILED")return!1;let q=w?.statusCode;if(typeof q==="number"){if(q===400||q===401||q===403)return!1;return!0}if(w?.code===535)return!1;return!0}class U{transports;provider="fallback";shouldFallback;onFallback;cooldownMs;now;unhealthyUntil;mailerOnFallback;constructor(w,q){this.transports=w;if(w.length===0)throw Error("FallbackTransport requires at least one transport");this.shouldFallback=q?.shouldFallback??T,this.onFallback=q?.onFallback,this.cooldownMs=q?.cooldownMs??0,this.now=q?.now??(()=>Date.now()),this.unhealthyUntil=q?.cooldownState??new Map}setMailerOnFallback(w){this.mailerOnFallback=w}isCoolingDown(w){let q=this.unhealthyUntil.get(w);if(q===void 0)return!1;if(this.now()>=q)return this.unhealthyUntil.delete(w),!1;return!0}markUnhealthy(w){if(this.cooldownMs>0)this.unhealthyUntil.set(w,this.now()+this.cooldownMs)}async send(w){let q=[],z=[];for(let G=0;G<this.transports.length;G++){let M=this.transports[G],D=J(M);if(this.isCoolingDown(D)){z.push({provider:D,error:Error(`Provider ${D} is in cooldown`)});continue}try{return{...await M.send(w),provider:D,providerIndex:G}}catch(H){q.push({provider:D,error:H}),this.markUnhealthy(D);let N=this.findNextTryIndex(G);if(N===-1)break;if(this.shouldFallback(H)===!1)throw H;let R=J(this.transports[N]);if(this.onFallback?.(G,H),this.mailerOnFallback!==void 0)await this.mailerOnFallback(D,R,H)}}let B=[...q,...z];if(B.length===0)throw new K([{provider:"fallback",error:Error("All providers are in cooldown")}]);throw new K(B)}findNextTryIndex(w){for(let q=w+1;q<this.transports.length;q++){let z=J(this.transports[q]);if(!this.isCoolingDown(z))return q}return-1}async verify(){let q=(await this.verifyAll()).providers.find((z)=>z.ok);if(q!==void 0)return{ok:!0,provider:q.provider,...q.message!==void 0?{message:q.message}:{}};return{ok:!1,provider:"fallback",message:"no transport verified"}}async verifyAll(){let w=[];for(let q of this.transports){let z=J(q);if(q.verify===void 0){w.push({provider:z,ok:!1,message:"no verify() method"});continue}try{let B=await q.verify();w.push({provider:z,ok:B.ok,...B.message!==void 0?{message:B.message}:{}})}catch(B){w.push({provider:z,ok:!1,message:B instanceof Error?B.message:String(B)})}}return{ok:w.some((q)=>q.ok),providers:w}}async close(){await Promise.allSettled(this.transports.map((w)=>w.close?.()))}}
-export{K as h,X as i,U as j};
-
-//# debugId=3C85F02B08FD5F1E64756E2164756E21

package/dist/chunk-qh90yr6d.js

@@ -1,4 +0,0 @@
-import{V}from"./chunk-5scdgffb.js";function W(q){for(let E=0;E<q.length;E++){let z=q.charCodeAt(E);if(z<=31||z===127||z===8232||z===8233)return z}return-1}function K(q,E="address"){let z=W(q);if(z!==-1){let G=z.toString(16).padStart(2,"0");throw Error(`Email ${E} contains a forbidden control character (0x${G}). CR, LF, NUL, and other control characters are not allowed.`)}}function X(q){if(Array.isArray(q))return q.flatMap((z)=>X(z));if(typeof q==="object"){if(K(q.address,"address"),q.name!==void 0)K(q.name,"display name");return[{...q}]}K(q,"address");let E=q.trim();if(!E)return[];return Y(E).map(Z)}function $(q){if(K(q.address,"address"),q.name)return K(q.name,"display name"),`${V(q.name)} <${q.address}>`;return q.address}function w(q){return X(q).map((E)=>E.address)}function x(q){if(W(q)!==-1)return!1;return/^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/.test(q)}function Y(q){let E=[],z="",G=!1,J=!1;for(let O=0;O<q.length;O++){let I=q[O]??"";if(I==='"'&&q[O-1]!=="\\"){G=!G,z+=I;continue}if(I==="<"&&!G){J=!0,z+=I;continue}if(I===">"&&!G){J=!1,z+=I;continue}if(I===","&&!G&&!J){if(z.trim())E.push(z.trim());z="";continue}z+=I}if(z.trim())E.push(z.trim());return E}function Z(q){let E=q.trim(),z=E.match(/^(?:"([^"]*)"|([^<]*?))\s*<([^>]+)>$/);if(z){let G=(z[1]??z[2]??"").trim(),J=(z[3]??"").trim();if(G)return{name:G,address:J};return{address:J}}if(E.startsWith('"')&&E.endsWith('"'))return{address:E.slice(1,-1)};return{address:E}}
-export{K as C,X as D,$ as E,w as F,x as G};
-
-//# debugId=80DC74FA55E2FA5964756E2164756E21

package/dist/chunk-vhxzhx8b.js

@@ -1,4 +0,0 @@
-import{_ as C}from"./chunk-nbmq8ejv.js";async function K(D,y){let E=D??[],j=[];for(let b of E){if(b.content instanceof Uint8Array){j.push(b);continue}if(b.path){let z;try{z=await import("node:fs/promises")}catch{throw Error("attachment.path is not supported on this runtime — use attachment.content (Uint8Array) instead")}if(y?.basePath){let{resolve:A,sep:H}=await import("node:path"),k=A(b.path),w=A(y.basePath);if(!(k===w||k.startsWith(w+H)))throw Error(`[sently] Attachment path "${k}" escapes basePath "${w}". Use absolute paths within the allowed directory.`)}let F=await z.readFile(b.path),{path:I,...G}=b;j.push({...G,content:new Uint8Array(F)});continue}if(typeof b.content==="string"){j.push(b);continue}j.push(b)}return j}
-export{K as v};
-
-//# debugId=3442FCDDB36F8C9264756E2164756E21

package/dist/chunk-wbvhaqcp.js

@@ -1,4 +0,0 @@
-import{T as D,W as J}from"./chunk-5scdgffb.js";var Q="https://oauth2.googleapis.com/token",$="https://login.microsoftonline.com/common/oauth2/v2.0/token",V=30000;class W{config;cachedToken=null;expiresAt=0;refreshPromise=null;constructor(m){if(this.config=m,m.accessToken)this.cachedToken=m.accessToken,this.expiresAt=Date.now()+3600000}async getAccessToken(){if(this.config.getToken)return this.config.getToken();if(this.cachedToken&&Date.now()<this.expiresAt-V)return this.cachedToken;if(!this.refreshPromise)this.refreshPromise=this.refreshAccessToken().finally(()=>{this.refreshPromise=null});return this.refreshPromise}async refreshAccessToken(){if(this.config.getToken){let v=await this.config.getToken();return this.cachedToken=v,this.expiresAt=Date.now()+3600000,v}let m=this.config.tokenUrl??Q,z=new URLSearchParams({client_id:this.config.clientId,client_secret:this.config.clientSecret,refresh_token:this.config.refreshToken,grant_type:"refresh_token"}),q=await fetch(m,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:z.toString()});if(!q.ok){let v=await q.text();throw Error(`OAuth2 token refresh failed (${q.status}): ${v}`)}let C=await q.json();return this.cachedToken=C.access_token,this.expiresAt=Date.now()+C.expires_in*1000,C.access_token}async buildXOAUTH2(){let m=await this.getAccessToken(),z=`user=${this.config.user}\x01auth=Bearer ${m}\x01\x01`;return D(J(z)).replace(/\r\n/g,"")}}
-export{Q as q,$ as r,W as s};
-
-//# debugId=81D6302F3F754CF964756E2164756E21

package/dist/chunk-wsymfbkn.js

@@ -1,4 +0,0 @@
-import{_ as q}from"./chunk-nbmq8ejv.js";function w(){if(typeof Bun<"u")return"bun";if(typeof Deno<"u")return"deno";if(typeof caches<"u"&&globalThis.navigator?.userAgent==="Cloudflare-Workers")return"cf-workers";if(typeof window<"u")return"browser";if(typeof process<"u"&&process.versions?.node)return"node";return"unknown"}async function x(k){let v=w();switch(v){case"node":{let{NodeAdapter:g}=await import("./adapters/node.js");return new g(k)}case"bun":{let{BunAdapter:g}=await import("./adapters/bun.js");return new g(k)}case"deno":{let{DenoAdapter:g}=await import("./adapters/deno.js");return new g(k)}case"cf-workers":{let{CloudflareAdapter:g}=await import("./adapters/cf.js");return new g(k)}default:throw Error(`No socket adapter available for runtime: ${v}`)}}
-export{w,x};
-
-//# debugId=5FF26FD321F29A4864756E2164756E21