sently 0.8.0 → 0.9.1

package/dist/webhooks/brevo.js

@@ -1,3 +1,3 @@
-import{d as F,e as u,f as G,g as H}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var K={delivered:"delivered",hard_bounce:"bounced",hardBounce:"bounced",soft_bounce:"bounced",soft_bounced:"bounced",softBounce:"bounced",blocked:"bounced",invalid:"bounced",invalid_email:"bounced",deferred:"deferred",spam:"complained",opened:"opened",unique_opened:"opened",uniqueOpened:"opened",click:"clicked",clicked:"clicked",unique_click:"clicked",uniqueClicked:"clicked",sent:"unknown",request:"unknown",unsubscribe:"complained",unsubscribed:"complained"};function L(f){return u(f.ts_event)??u(f.ts)??u(f.date_event)??u(f.date)??u(f.ts_epoch!==void 0?Number(f.ts_epoch):void 0)}function Q(f){if(typeof f["message-id"]==="string")return f["message-id"];if(typeof f.messageId==="string")return f.messageId;return}function U(f){return G(f).flatMap((x)=>{if(typeof x!=="object"||x===null)return[];let q=x,J=typeof q.event==="string"?q.event:"",C=L(q),D=Q(q);return[H({provider:"brevo",type:F(J,K),...D!==void 0?{messageId:D}:{},...typeof q.email==="string"?{recipient:q.email}:{},...C!==void 0?{timestamp:C}:{},raw:x})]})}export{U as parse};
+import{d as F,e as u,f as G,g as H}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var K={delivered:"delivered",hard_bounce:"bounced",hardBounce:"bounced",soft_bounce:"bounced",soft_bounced:"bounced",softBounce:"bounced",blocked:"bounced",invalid:"bounced",invalid_email:"bounced",deferred:"deferred",spam:"complained",opened:"opened",unique_opened:"opened",uniqueOpened:"opened",click:"clicked",clicked:"clicked",unique_click:"clicked",uniqueClicked:"clicked",sent:"unknown",request:"unknown",unsubscribe:"complained",unsubscribed:"complained"};function L(f){return u(f.ts_event)??u(f.ts)??u(f.date_event)??u(f.date)??u(f.ts_epoch!==void 0?Number(f.ts_epoch):void 0)}function Q(f){if(typeof f["message-id"]==="string")return f["message-id"];if(typeof f.messageId==="string")return f.messageId;return}function U(f){return G(f).flatMap((x)=>{if(typeof x!=="object"||x===null)return[];let q=x,J=typeof q.event==="string"?q.event:"",C=L(q),D=Q(q);return[H({provider:"brevo",type:F(J,K),...D!==void 0?{messageId:D}:{},...typeof q.email==="string"?{recipient:q.email}:{},...C!==void 0?{timestamp:C}:{},raw:x})]})}export{U as parse};
 
 //# debugId=916BC5D0AADEB5C764756E2164756E21

package/dist/webhooks/mailgun.js

@@ -1,3 +1,3 @@
-import{a as G,c as H}from"../chunk-pqp843mh.js";import{d as Y,e as Z,g as $}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var R={accepted:"unknown",delivered:"delivered",rejected:"bounced",complained:"complained",opened:"opened",clicked:"clicked",stored:"unknown",unsubscribed:"unknown"};function U(z){let J=typeof z.event==="string"?z.event:"";if(J==="failed")return z.severity==="temporary"?"deferred":"bounced";return Y(J,R)}function b(z){if(!z)return;let J=z.headers;if(typeof J==="object"&&J!==null){let C=J["message-id"];if(typeof C==="string")return C}return typeof z["message-id"]==="string"?z["message-id"]:void 0}function N(z){if(typeof z!=="object"||z===null)return[];let J=z,C=typeof J["event-data"]==="object"&&J["event-data"]!==null?J["event-data"]:J,O=typeof C.message==="object"&&C.message!==null?C.message:void 0,Q=b(O),W=Z(C.timestamp);return[$({provider:"mailgun",type:U(C),...Q!==void 0?{messageId:Q}:{},...typeof C.recipient==="string"?{recipient:C.recipient}:{},...W!==void 0?{timestamp:W}:{},raw:z})]}async function q(z,J,C,O){let Q=await crypto.subtle.importKey("raw",new TextEncoder().encode(O),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),W=new TextEncoder().encode(z+J),L=await crypto.subtle.sign("HMAC",Q,W),P=new Uint8Array(L),X=H(C);if(X===null)return!1;return G(P,X)}async function S(z,J){if(typeof z!=="object"||z===null)return!1;let C=z.signature;if(typeof C!=="object"||C===null)return!1;let O=C;if(typeof O.timestamp!=="string"||typeof O.token!=="string"||typeof O.signature!=="string")return!1;return q(O.timestamp,O.token,O.signature,J)}export{q as verifySignature,S as verifyPayload,N as parse};
+import{a as G,c as H}from"../chunk-pqp843mh.js";import{d as Y,e as Z,g as $}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var R={accepted:"unknown",delivered:"delivered",rejected:"bounced",complained:"complained",opened:"opened",clicked:"clicked",stored:"unknown",unsubscribed:"unknown"};function U(z){let J=typeof z.event==="string"?z.event:"";if(J==="failed")return z.severity==="temporary"?"deferred":"bounced";return Y(J,R)}function b(z){if(!z)return;let J=z.headers;if(typeof J==="object"&&J!==null){let C=J["message-id"];if(typeof C==="string")return C}return typeof z["message-id"]==="string"?z["message-id"]:void 0}function N(z){if(typeof z!=="object"||z===null)return[];let J=z,C=typeof J["event-data"]==="object"&&J["event-data"]!==null?J["event-data"]:J,O=typeof C.message==="object"&&C.message!==null?C.message:void 0,Q=b(O),W=Z(C.timestamp);return[$({provider:"mailgun",type:U(C),...Q!==void 0?{messageId:Q}:{},...typeof C.recipient==="string"?{recipient:C.recipient}:{},...W!==void 0?{timestamp:W}:{},raw:z})]}async function q(z,J,C,O){let Q=await crypto.subtle.importKey("raw",new TextEncoder().encode(O),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),W=new TextEncoder().encode(z+J),L=await crypto.subtle.sign("HMAC",Q,W),P=new Uint8Array(L),X=H(C);if(X===null)return!1;return G(P,X)}async function S(z,J){if(typeof z!=="object"||z===null)return!1;let C=z.signature;if(typeof C!=="object"||C===null)return!1;let O=C;if(typeof O.timestamp!=="string"||typeof O.token!=="string"||typeof O.signature!=="string")return!1;return q(O.timestamp,O.token,O.signature,J)}export{q as verifySignature,S as verifyPayload,N as parse};
 
 //# debugId=7FB21CD9E29B4FE264756E2164756E21

package/dist/webhooks/postmark.js

@@ -1,3 +1,3 @@
-import{d as u,e as q,g as x}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var C={Delivery:"delivered",Bounce:"bounced",SpamComplaint:"complained",Open:"opened",Click:"clicked",SubscriptionChange:"unknown",Inbound:"unknown"};function F(g){if(typeof g!=="object"||g===null)return[];let f=g,B=typeof f.RecordType==="string"?f.RecordType:"";return[x({provider:"postmark",type:u(B,C),...typeof f.MessageID==="string"?{messageId:f.MessageID}:{},...typeof f.Recipient==="string"?{recipient:f.Recipient}:typeof f.Email==="string"?{recipient:f.Email}:{},...q(f.DeliveredAt??f.BouncedAt??f.ReceivedAt??f.ChangedAt)!==void 0?{timestamp:q(f.DeliveredAt??f.BouncedAt??f.ReceivedAt??f.ChangedAt)}:{},raw:g})]}export{F as parse};
+import{d as u,e as q,g as x}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var C={Delivery:"delivered",Bounce:"bounced",SpamComplaint:"complained",Open:"opened",Click:"clicked",SubscriptionChange:"unknown",Inbound:"unknown"};function F(g){if(typeof g!=="object"||g===null)return[];let f=g,B=typeof f.RecordType==="string"?f.RecordType:"";return[x({provider:"postmark",type:u(B,C),...typeof f.MessageID==="string"?{messageId:f.MessageID}:{},...typeof f.Recipient==="string"?{recipient:f.Recipient}:typeof f.Email==="string"?{recipient:f.Email}:{},...q(f.DeliveredAt??f.BouncedAt??f.ReceivedAt??f.ChangedAt)!==void 0?{timestamp:q(f.DeliveredAt??f.BouncedAt??f.ReceivedAt??f.ChangedAt)}:{},raw:g})]}export{F as parse};
 
 //# debugId=7CD05BB54D484C3864756E2164756E21

package/dist/webhooks/resend.js

@@ -1,3 +1,3 @@
-import{a as $,b as A}from"../chunk-pqp843mh.js";import{d as X,e as Y,g as Z}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var j={"email.sent":"unknown","email.scheduled":"unknown","email.delivered":"delivered","email.delivery_delayed":"deferred","email.bounced":"bounced","email.failed":"bounced","email.complained":"complained","email.opened":"opened","email.clicked":"clicked","email.received":"unknown","email.suppressed":"unknown"};function k(G){let F=G.startsWith("whsec_")?G.slice(6):G,K=atob(F),J=new Uint8Array(K.length);for(let z=0;z<K.length;z++)J[z]=K.charCodeAt(z);return J.buffer}function H(G){if(typeof G!=="object"||G===null)return[];let F=G,K=typeof F.type==="string"?F.type:"",J=typeof F.data==="object"&&F.data!==null?F.data:{},z=J.to,L=Array.isArray(z)?typeof z[0]==="string"?z[0]:void 0:typeof z==="string"?z:void 0,O=Y(F.created_at??J.created_at);return[Z({provider:"resend",type:X(K,j),...typeof J.email_id==="string"?{messageId:J.email_id}:{},...L!==void 0?{recipient:L}:{},...O!==void 0?{timestamp:O}:{},raw:G})]}async function I(G,F,K){let J=F["svix-id"],z=F["svix-timestamp"],L=F["svix-signature"];if(!J||!z||!L)return!1;let O=`${J}.${z}.${G}`,D=await crypto.subtle.importKey("raw",k(K),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),M=await crypto.subtle.sign("HMAC",D,new TextEncoder().encode(O)),P=new Uint8Array(M);for(let W of L.split(" ")){let Q=W.split(",",2)[1];if(Q===void 0)continue;let U=A(Q);if(U===null)continue;if($(P,U))return!0}return!1}export{I as verifySignature,H as parse};
+import{a as $,b as A}from"../chunk-pqp843mh.js";import{d as X,e as Y,g as Z}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var j={"email.sent":"unknown","email.scheduled":"unknown","email.delivered":"delivered","email.delivery_delayed":"deferred","email.bounced":"bounced","email.failed":"bounced","email.complained":"complained","email.opened":"opened","email.clicked":"clicked","email.received":"unknown","email.suppressed":"unknown"};function k(G){let F=G.startsWith("whsec_")?G.slice(6):G,K=atob(F),J=new Uint8Array(K.length);for(let z=0;z<K.length;z++)J[z]=K.charCodeAt(z);return J.buffer}function H(G){if(typeof G!=="object"||G===null)return[];let F=G,K=typeof F.type==="string"?F.type:"",J=typeof F.data==="object"&&F.data!==null?F.data:{},z=J.to,L=Array.isArray(z)?typeof z[0]==="string"?z[0]:void 0:typeof z==="string"?z:void 0,O=Y(F.created_at??J.created_at);return[Z({provider:"resend",type:X(K,j),...typeof J.email_id==="string"?{messageId:J.email_id}:{},...L!==void 0?{recipient:L}:{},...O!==void 0?{timestamp:O}:{},raw:G})]}async function I(G,F,K){let J=F["svix-id"],z=F["svix-timestamp"],L=F["svix-signature"];if(!J||!z||!L)return!1;let O=`${J}.${z}.${G}`,D=await crypto.subtle.importKey("raw",k(K),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),M=await crypto.subtle.sign("HMAC",D,new TextEncoder().encode(O)),P=new Uint8Array(M);for(let W of L.split(" ")){let Q=W.split(",",2)[1];if(Q===void 0)continue;let U=A(Q);if(U===null)continue;if($(P,U))return!0}return!1}export{I as verifySignature,H as parse};
 
 //# debugId=2EA62D07463E258664756E2164756E21

package/dist/webhooks/sendgrid.js

@@ -1,3 +1,3 @@
-import{d as w,e as x,f as B,g as C}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var F={processed:"unknown",delivered:"delivered",deferred:"deferred",bounce:"bounced",dropped:"bounced",spamreport:"complained",unsubscribe:"complained",group_unsubscribe:"complained",group_resubscribe:"unknown",open:"opened",click:"clicked"};function H(q){let g=typeof q.event==="string"?q.event:"";if(g==="bounce"&&q.type==="blocked")return"deferred";return w(g,F)}function K(q){return B(q).flatMap((g)=>{if(typeof g!=="object"||g===null)return[];let f=g,u=x(f.timestamp);return[C({provider:"sendgrid",type:H(f),...typeof f.sg_message_id==="string"?{messageId:f.sg_message_id}:typeof f["smtp-id"]==="string"?{messageId:f["smtp-id"]}:{},...typeof f.email==="string"?{recipient:f.email}:{},...u!==void 0?{timestamp:u}:{},raw:g})]})}export{K as parse};
+import{d as w,e as x,f as B,g as C}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var F={processed:"unknown",delivered:"delivered",deferred:"deferred",bounce:"bounced",dropped:"bounced",spamreport:"complained",unsubscribe:"complained",group_unsubscribe:"complained",group_resubscribe:"unknown",open:"opened",click:"clicked"};function H(q){let g=typeof q.event==="string"?q.event:"";if(g==="bounce"&&q.type==="blocked")return"deferred";return w(g,F)}function K(q){return B(q).flatMap((g)=>{if(typeof g!=="object"||g===null)return[];let f=g,u=x(f.timestamp);return[C({provider:"sendgrid",type:H(f),...typeof f.sg_message_id==="string"?{messageId:f.sg_message_id}:typeof f["smtp-id"]==="string"?{messageId:f["smtp-id"]}:{},...typeof f.email==="string"?{recipient:f.email}:{},...u!==void 0?{timestamp:u}:{},raw:g})]})}export{K as parse};
 
 //# debugId=D4C7DDEE719D449764756E2164756E21

package/dist/webhooks/ses.js

@@ -1,3 +1,3 @@
-import{d as Q,e as U,g as X}from"../chunk-q8k3m6qe.js";import"../chunk-nbmq8ejv.js";var $={Delivery:"delivered",Bounce:"bounced",Complaint:"complained",Open:"opened",Click:"clicked",DeliveryDelay:"deferred",Send:"unknown",Reject:"bounced","Rendering Failure":"bounced",Subscription:"unknown"};function h(q){if(typeof q.eventType==="string")return q.eventType;if(typeof q.notificationType==="string")return q.notificationType;return""}function j(q){let J=typeof q.delivery==="object"&&q.delivery!==null?q.delivery:void 0;if(J&&Array.isArray(J.recipients)&&typeof J.recipients[0]==="string")return J.recipients[0];let K=typeof q.bounce==="object"&&q.bounce!==null?q.bounce:void 0;if(K&&Array.isArray(K.bouncedRecipients)){let I=K.bouncedRecipients[0];if(typeof I==="object"&&I!==null&&typeof I.emailAddress==="string")return I.emailAddress}let B=typeof q.complaint==="object"&&q.complaint!==null?q.complaint:void 0;if(B&&Array.isArray(B.complainedRecipients)){let I=B.complainedRecipients[0];if(typeof I==="object"&&I!==null&&typeof I.emailAddress==="string")return I.emailAddress}let G=typeof q.mail==="object"&&q.mail!==null?q.mail:void 0;if(Array.isArray(G?.destination)&&typeof G.destination[0]==="string")return G.destination[0];return}function w(q){let J=h(q),K=typeof q.mail==="object"&&q.mail!==null?q.mail:void 0,B=typeof q.bounce==="object"&&q.bounce!==null?q.bounce:void 0,G=typeof q.complaint==="object"&&q.complaint!==null?q.complaint:void 0,I=typeof q.open==="object"&&q.open!==null?q.open:void 0,Y=typeof q.click==="object"&&q.click!==null?q.click:void 0,Z=typeof q.deliveryDelay==="object"&&q.deliveryDelay!==null?q.deliveryDelay:void 0,L=j(q),O=U(q.timestamp??B?.timestamp??G?.timestamp??I?.timestamp??Y?.timestamp??Z?.timestamp??K?.timestamp);return[X({provider:"ses",type:Q(J,$),...typeof K?.messageId==="string"?{messageId:K.messageId}:{},...L!==void 0?{recipient:L}:{},...O!==void 0?{timestamp:O}:{},raw:q})]}function z(q){if(typeof q!=="object"||q===null)return[];let J=q,K=typeof J.Type==="string"?J.Type:"";if(K==="SubscriptionConfirmation")return[];if(K!=="Notification")return[];let B=J.Message,G;if(typeof B==="string")try{G=JSON.parse(B)}catch{return[{provider:"ses",type:"unknown",raw:q}]}else if(typeof B==="object"&&B!==null)G=B;else return[];if(typeof G!=="object"||G===null)return[{provider:"ses",type:"unknown",raw:q}];return w(G)}export{z as parse};
+import{d as Q,e as U,g as X}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var $={Delivery:"delivered",Bounce:"bounced",Complaint:"complained",Open:"opened",Click:"clicked",DeliveryDelay:"deferred",Send:"unknown",Reject:"bounced","Rendering Failure":"bounced",Subscription:"unknown"};function h(q){if(typeof q.eventType==="string")return q.eventType;if(typeof q.notificationType==="string")return q.notificationType;return""}function j(q){let J=typeof q.delivery==="object"&&q.delivery!==null?q.delivery:void 0;if(J&&Array.isArray(J.recipients)&&typeof J.recipients[0]==="string")return J.recipients[0];let K=typeof q.bounce==="object"&&q.bounce!==null?q.bounce:void 0;if(K&&Array.isArray(K.bouncedRecipients)){let I=K.bouncedRecipients[0];if(typeof I==="object"&&I!==null&&typeof I.emailAddress==="string")return I.emailAddress}let B=typeof q.complaint==="object"&&q.complaint!==null?q.complaint:void 0;if(B&&Array.isArray(B.complainedRecipients)){let I=B.complainedRecipients[0];if(typeof I==="object"&&I!==null&&typeof I.emailAddress==="string")return I.emailAddress}let G=typeof q.mail==="object"&&q.mail!==null?q.mail:void 0;if(Array.isArray(G?.destination)&&typeof G.destination[0]==="string")return G.destination[0];return}function w(q){let J=h(q),K=typeof q.mail==="object"&&q.mail!==null?q.mail:void 0,B=typeof q.bounce==="object"&&q.bounce!==null?q.bounce:void 0,G=typeof q.complaint==="object"&&q.complaint!==null?q.complaint:void 0,I=typeof q.open==="object"&&q.open!==null?q.open:void 0,Y=typeof q.click==="object"&&q.click!==null?q.click:void 0,Z=typeof q.deliveryDelay==="object"&&q.deliveryDelay!==null?q.deliveryDelay:void 0,L=j(q),O=U(q.timestamp??B?.timestamp??G?.timestamp??I?.timestamp??Y?.timestamp??Z?.timestamp??K?.timestamp);return[X({provider:"ses",type:Q(J,$),...typeof K?.messageId==="string"?{messageId:K.messageId}:{},...L!==void 0?{recipient:L}:{},...O!==void 0?{timestamp:O}:{},raw:q})]}function z(q){if(typeof q!=="object"||q===null)return[];let J=q,K=typeof J.Type==="string"?J.Type:"";if(K==="SubscriptionConfirmation")return[];if(K!=="Notification")return[];let B=J.Message,G;if(typeof B==="string")try{G=JSON.parse(B)}catch{return[{provider:"ses",type:"unknown",raw:q}]}else if(typeof B==="object"&&B!==null)G=B;else return[];if(typeof G!=="object"||G===null)return[{provider:"ses",type:"unknown",raw:q}];return w(G)}export{z as parse};
 
 //# debugId=C5FC4A2C6082819B64756E2164756E21

package/dist/webhooks/sndr.d.ts

@@ -0,0 +1,16 @@
+import type { EmailEvent } from "./types.js";
+/** Parse an SNDR webhook payload into normalized {@link EmailEvent} records. */
+export declare function parse(payload: unknown): EmailEvent[];
+/**
+ * Verify an SNDR webhook signature using HMAC-SHA256 (Web Crypto).
+ *
+ * Pass the **exact** raw request body string — re-serializing JSON breaks the HMAC.
+ *
+ * @param rawBody — Raw HTTP body bytes as UTF-8 string (or the string used when signing).
+ * @param signatureHeader — Value of the `X-Sndr-Signature` header (`t=…,v1=…`).
+ * @param secret — Webhook endpoint signing secret from SNDR.
+ * @param opts.toleranceSeconds — Max age of `t` in seconds (default `300`). Pass `0` to skip.
+ */
+export declare function verifySignature(rawBody: string, signatureHeader: string, secret: string, opts?: {
+    toleranceSeconds?: number;
+}): Promise<boolean>;

package/dist/webhooks/sndr.js

@@ -0,0 +1,3 @@
+import{a as W,c as _}from"../chunk-pqp843mh.js";import{d as U,e as X,g as j}from"../chunk-q8k3m6qe.js";import"../chunk-6npp3x3c.js";var x={"email.delivered":"delivered","email.bounced":"bounced","email.unsubscribed":"unknown"};function P(K){if(typeof K!=="object"||K===null)return[];let I=K,z=typeof I.type==="string"?I.type:"",L=typeof I.data==="object"&&I.data!==null?I.data:{},G=L.to??L.addresses,Q=Array.isArray(G)?typeof G[0]==="string"?G[0]:void 0:typeof G==="string"?G:void 0,Z=X(I.created_at);return[j({provider:"sndr",type:U(z,x),...typeof L.email_id==="string"?{messageId:L.email_id}:{},...Q!==void 0?{recipient:Q}:{},...Z!==void 0?{timestamp:Z}:{},raw:K})]}async function R(K,I,z,L){if(!I||!z)return!1;let G,Q;for(let Y of I.split(",")){let $=Y.indexOf("=");if($<0)continue;let J=Y.slice(0,$).trim(),O=Y.slice($+1).trim();if(J==="t")G=O;else if(J==="v1")Q=O}if(!G||!Q)return!1;let Z=L?.toleranceSeconds??300;if(Z>0){let Y=Number(G);if(!Number.isFinite(Y))return!1;let $=Math.floor(Date.now()/1000);if(Math.abs($-Y)>Z)return!1}let F=_(Q);if(F===null)return!1;let C=await crypto.subtle.importKey("raw",new TextEncoder().encode(z),{name:"HMAC",hash:"SHA-256"},!1,["sign"]),D=new TextEncoder().encode(`${G}.${K}`),V=await crypto.subtle.sign("HMAC",C,D);return W(new Uint8Array(V),F)}export{R as verifySignature,P as parse};
+
+//# debugId=7647757468D3D2B664756E2164756E21

package/dist/webhooks/sndr.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/webhooks/sndr.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * SNDR webhook parser and signature verification.\n *\n * Signature scheme (from `@rkiza/sndr` / SNDR dispatcher):\n * `X-Sndr-Signature: t=<unix_seconds>,v1=<hex(HMAC-SHA256(secret, `${t}.${rawBody}`))>`\n */\nimport { decodeHexBytes, timingSafeEqual } from \"./timing-safe-equal.js\";\nimport type { EmailEvent } from \"./types.js\";\nimport { emailEvent, mapEventType, parseTimestamp } from \"./types.js\";\n\nconst SNDR_EVENT_MAP: Record<string, EmailEvent[\"type\"]> = {\n  \"email.delivered\": \"delivered\",\n  \"email.bounced\": \"bounced\",\n  \"email.unsubscribed\": \"unknown\",\n};\n\n/** Parse an SNDR webhook payload into normalized {@link EmailEvent} records. */\nexport function parse(payload: unknown): EmailEvent[] {\n  if (typeof payload !== \"object\" || payload === null) {\n    return [];\n  }\n\n  const record = payload as Record<string, unknown>;\n  const type = typeof record.type === \"string\" ? record.type : \"\";\n  const data =\n    typeof record.data === \"object\" && record.data !== null\n      ? (record.data as Record<string, unknown>)\n      : {};\n\n  const to = data.to ?? data.addresses;\n  const recipient = Array.isArray(to)\n    ? typeof to[0] === \"string\"\n      ? to[0]\n      : undefined\n    : typeof to === \"string\"\n      ? to\n      : undefined;\n\n  const timestamp = parseTimestamp(record.created_at);\n\n  return [\n    emailEvent({\n      provider: \"sndr\",\n      type: mapEventType(type, SNDR_EVENT_MAP),\n      ...(typeof data.email_id === \"string\" ? { messageId: data.email_id } : {}),\n      ...(recipient !== undefined ? { recipient } : {}),\n      ...(timestamp !== undefined ? { timestamp } : {}),\n      raw: payload,\n    }),\n  ];\n}\n\n/**\n * Verify an SNDR webhook signature using HMAC-SHA256 (Web Crypto).\n *\n * Pass the **exact** raw request body string — re-serializing JSON breaks the HMAC.\n *\n * @param rawBody — Raw HTTP body bytes as UTF-8 string (or the string used when signing).\n * @param signatureHeader — Value of the `X-Sndr-Signature` header (`t=…,v1=…`).\n * @param secret — Webhook endpoint signing secret from SNDR.\n * @param opts.toleranceSeconds — Max age of `t` in seconds (default `300`). Pass `0` to skip.\n */\nexport async function verifySignature(\n  rawBody: string,\n  signatureHeader: string,\n  secret: string,\n  opts?: { toleranceSeconds?: number },\n): Promise<boolean> {\n  if (!signatureHeader || !secret) {\n    return false;\n  }\n\n  let timestamp: string | undefined;\n  let v1: string | undefined;\n  for (const part of signatureHeader.split(\",\")) {\n    const eq = part.indexOf(\"=\");\n    if (eq < 0) continue;\n    const key = part.slice(0, eq).trim();\n    const value = part.slice(eq + 1).trim();\n    if (key === \"t\") timestamp = value;\n    else if (key === \"v1\") v1 = value;\n  }\n\n  if (!timestamp || !v1) {\n    return false;\n  }\n\n  const tolerance = opts?.toleranceSeconds ?? 300;\n  if (tolerance > 0) {\n    const tsNum = Number(timestamp);\n    if (!Number.isFinite(tsNum)) {\n      return false;\n    }\n    const nowSec = Math.floor(Date.now() / 1000);\n    if (Math.abs(nowSec - tsNum) > tolerance) {\n      return false;\n    }\n  }\n\n  const providedBytes = decodeHexBytes(v1);\n  if (providedBytes === null) {\n    return false;\n  }\n\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    new TextEncoder().encode(secret),\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"],\n  );\n\n  const signed = new TextEncoder().encode(`${timestamp}.${rawBody}`);\n  const expected = await crypto.subtle.sign(\"HMAC\", key, signed);\n  return timingSafeEqual(new Uint8Array(expected), providedBytes);\n}\n"
+  ],
+  "mappings": "8IAWA,DAAM,HAAqD,CACzD,kBAAmB,YACnB,gBAAiB,UACjB,qBAAsB,SACxB,EAGO,SAAS,CAAK,CAAC,EAAgC,CACpD,GAAI,OAAO,IAAY,UAAY,IAAY,KAC7C,MAAO,CAAC,EAGV,IAAM,EAAS,EACT,EAAO,OAAO,EAAO,OAAS,SAAW,EAAO,KAAO,GACvD,EACJ,OAAO,EAAO,OAAS,UAAY,EAAO,OAAS,KAC9C,EAAO,KACR,CAAC,EAED,EAAK,EAAK,IAAM,EAAK,UACrB,EAAY,MAAM,QAAQ,CAAE,EAC9B,OAAO,EAAG,KAAO,SACf,EAAG,GACH,OACF,OAAO,IAAO,SACZ,EACA,OAEA,EAAY,EAAe,EAAO,UAAU,EAElD,MAAO,CACL,EAAW,CACT,SAAU,OACV,KAAM,EAAa,EAAM,CAAc,KACnC,OAAO,EAAK,WAAa,SAAW,CAAE,UAAW,EAAK,QAAS,EAAI,CAAC,KACpE,IAAc,OAAY,CAAE,WAAU,EAAI,CAAC,KAC3C,IAAc,OAAY,CAAE,WAAU,EAAI,CAAC,EAC/C,IAAK,CACP,CAAC,CACH,EAaF,eAAsB,CAAe,CACnC,EACA,EACA,EACA,EACkB,CAClB,GAAI,CAAC,GAAmB,CAAC,EACvB,MAAO,GAGT,IAAI,EACA,EACJ,QAAW,KAAQ,EAAgB,MAAM,GAAG,EAAG,CAC7C,IAAM,EAAK,EAAK,QAAQ,GAAG,EAC3B,GAAI,EAAK,EAAG,SACZ,IAAM,EAAM,EAAK,MAAM,EAAG,CAAE,EAAE,KAAK,EAC7B,EAAQ,EAAK,MAAM,EAAK,CAAC,EAAE,KAAK,EACtC,GAAI,IAAQ,IAAK,EAAY,EACxB,QAAI,IAAQ,KAAM,EAAK,EAG9B,GAAI,CAAC,GAAa,CAAC,EACjB,MAAO,GAGT,IAAM,EAAY,GAAM,kBAAoB,IAC5C,GAAI,EAAY,EAAG,CACjB,IAAM,EAAQ,OAAO,CAAS,EAC9B,GAAI,CAAC,OAAO,SAAS,CAAK,EACxB,MAAO,GAET,IAAM,EAAS,KAAK,MAAM,KAAK,IAAI,EAAI,IAAI,EAC3C,GAAI,KAAK,IAAI,EAAS,CAAK,EAAI,EAC7B,MAAO,GAIX,IAAM,EAAgB,EAAe,CAAE,EACvC,GAAI,IAAkB,KACpB,MAAO,GAGT,IAAM,EAAM,MAAM,OAAO,OAAO,UAC9B,MACA,IAAI,YAAY,EAAE,OAAO,CAAM,EAC/B,CAAE,KAAM,OAAQ,KAAM,SAAU,EAChC,GACA,CAAC,MAAM,CACT,EAEM,EAAS,IAAI,YAAY,EAAE,OAAO,GAAG,KAAa,GAAS,EAC3D,EAAW,MAAM,OAAO,OAAO,KAAK,OAAQ,EAAK,CAAM,EAC7D,OAAO,EAAgB,IAAI,WAAW,CAAQ,EAAG,CAAa",
+  "debugId": "7647757468D3D2B664756E2164756E21",
+  "names": []
+}

package/dist/webhooks/timing-safe-equal.js

@@ -1,3 +1,3 @@
-import{a,b,c}from"../chunk-pqp843mh.js";import"../chunk-nbmq8ejv.js";export{a as timingSafeEqual,c as decodeHexBytes,b as decodeBase64Bytes};
+import{a,b,c}from"../chunk-pqp843mh.js";import"../chunk-6npp3x3c.js";export{a as timingSafeEqual,c as decodeHexBytes,b as decodeBase64Bytes};
 
 //# debugId=CA7D50FE7388E14864756E2164756E21

package/dist/webhooks.d.ts

@@ -5,11 +5,17 @@
  * Pure parsing only; no server framework required. Signature verification
  * helpers are optional and never required to call `parse`.
  *
+ * Prefer per-provider subpaths for the smallest runtime graph
+ * (`sently/webhooks/resend`, `sently/webhooks/sndr`, …). This barrel re-exports
+ * every parser for convenience — bundlers tree-shake unused named imports, but
+ * Node/Deno without a bundler evaluate every re-export.
+ *
  * @example
  * ```ts
- * import { parseResendWebhook } from "sently/webhooks";
+ * import { parse } from "sently/webhooks/resend";
+ * // or: import { parseResendWebhook } from "sently/webhooks";
  *
- * const events = parseResendWebhook(await request.json());
+ * const events = parse(await request.json());
  * for (const event of events) {
  *   if (event.type === "bounced") {
  *     // handle bounce
@@ -23,4 +29,5 @@ export { parse as parsePostmarkWebhook } from "./webhooks/postmark.js";
 export { parse as parseResendWebhook, verifySignature as verifyResendSignature, } from "./webhooks/resend.js";
 export { parse as parseSendGridWebhook } from "./webhooks/sendgrid.js";
 export { parse as parseSesWebhook } from "./webhooks/ses.js";
+export { parse as parseSndrWebhook, verifySignature as verifySndrSignature, } from "./webhooks/sndr.js";
 export type { EmailEvent } from "./webhooks/types.js";

package/dist/webhooks.js

@@ -11,3 +11,7 @@ export {
 } from "./webhooks/resend.js";
 export { parse as parseSendGridWebhook } from "./webhooks/sendgrid.js";
 export { parse as parseSesWebhook } from "./webhooks/ses.js";
+export {
+  parse as parseSndrWebhook,
+  verifySignature as verifySndrSignature,
+} from "./webhooks/sndr.js";

package/dist/whatsapp.d.ts

@@ -0,0 +1,26 @@
+import type { VerifyResult } from "./core/types.js";
+import type { WhatsAppHooks, WhatsAppOptions, WhatsAppPlugin, WhatsAppSendResult, WhatsAppTransport } from "./core/whatsapp-types.js";
+/** Configuration for {@link createWhatsAppSender}. */
+export interface WhatsAppSenderConfig {
+    /** WhatsApp delivery transport. */
+    transport: WhatsAppTransport;
+    /** Optional plugins run before each send. */
+    plugins?: WhatsAppPlugin[];
+    /** Optional lifecycle hooks for metrics and tracing. */
+    hooks?: WhatsAppHooks;
+}
+/** WhatsApp sender returned by {@link createWhatsAppSender}. */
+export interface WhatsAppSender {
+    /** Send a WhatsApp message through the configured transport. */
+    send(options: WhatsAppOptions): Promise<WhatsAppSendResult>;
+    /** Test connectivity and credentials without sending. */
+    verify(): Promise<VerifyResult>;
+    /** Release resources held by the transport. */
+    close(): Promise<void>;
+}
+/**
+ * Create a WhatsApp sender that wraps a {@link WhatsAppTransport}.
+ *
+ * Pipeline: plugins → onSend → transport.send → onSuccess / onError.
+ */
+export declare function createWhatsAppSender(config: WhatsAppSenderConfig): WhatsAppSender;

package/dist/whatsapp.js

@@ -0,0 +1,3 @@
+import{W as z,X as I}from"./chunk-qtkd5bak.js";import"./chunk-6npp3x3c.js";function M(y,m){return{...y.messageId!==void 0?{messageId:y.messageId}:{},to:y.to,provider:m.provider??"whatsapp"}}function Q(y){let{transport:m,plugins:J,hooks:B}=y;return{async send(K){let F=await I(K,J),D=M(F,m);await z(B?.onSend,D);let G=performance.now();try{let q=await m.send(F),L={...D,messageId:q.messageId};return await z(B?.onSuccess,L,q,performance.now()-G),q}catch(q){throw await z(B?.onError,D,q,performance.now()-G),q}},async verify(){if(m.verify)return m.verify();return{ok:!0,provider:"whatsapp"}},async close(){if(m.close)await m.close()}}}export{Q as createWhatsAppSender};
+
+//# debugId=A4F982D22B2A1BB164756E2164756E21

package/dist/whatsapp.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/whatsapp.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * WhatsApp sender orchestrator — plugins, hooks, and transport.send pipeline.\n *\n * Sently-first: apps call {@link createWhatsAppSender}; providers implement\n * {@link WhatsAppTransport}. Multi-product vendors get a separate WhatsApp\n * transport (e.g. future `taqnyat-whatsapp`), not a mega vendor client.\n *\n * @example\n * ```ts\n * import { createWhatsAppSender } from \"sently/whatsapp\";\n * import { WhatsAppCloudTransport } from \"sently/transports/whatsapp-cloud\";\n *\n * const wa = createWhatsAppSender({\n *   transport: new WhatsAppCloudTransport({\n *     accessToken: \"...\",\n *     phoneNumberId: \"...\",\n *   }),\n * });\n *\n * await wa.send({ to: \"15551234567\", text: \"Hello\" });\n * ```\n */\nimport { invokeHook } from \"./core/hooks.js\";\nimport { runPlugins } from \"./core/plugin.js\";\nimport type { VerifyResult } from \"./core/types.js\";\nimport type {\n  WhatsAppHookContext,\n  WhatsAppHooks,\n  WhatsAppOptions,\n  WhatsAppPlugin,\n  WhatsAppSendResult,\n  WhatsAppTransport,\n} from \"./core/whatsapp-types.js\";\n\n/** Configuration for {@link createWhatsAppSender}. */\nexport interface WhatsAppSenderConfig {\n  /** WhatsApp delivery transport. */\n  transport: WhatsAppTransport;\n  /** Optional plugins run before each send. */\n  plugins?: WhatsAppPlugin[];\n  /** Optional lifecycle hooks for metrics and tracing. */\n  hooks?: WhatsAppHooks;\n}\n\n/** WhatsApp sender returned by {@link createWhatsAppSender}. */\nexport interface WhatsAppSender {\n  /** Send a WhatsApp message through the configured transport. */\n  send(options: WhatsAppOptions): Promise<WhatsAppSendResult>;\n  /** Test connectivity and credentials without sending. */\n  verify(): Promise<VerifyResult>;\n  /** Release resources held by the transport. */\n  close(): Promise<void>;\n}\n\nfunction buildWhatsAppHookContext(\n  options: WhatsAppOptions,\n  transport: WhatsAppTransport,\n): WhatsAppHookContext {\n  return {\n    ...(options.messageId !== undefined ? { messageId: options.messageId } : {}),\n    to: options.to,\n    provider: transport.provider ?? \"whatsapp\",\n  };\n}\n\n/**\n * Create a WhatsApp sender that wraps a {@link WhatsAppTransport}.\n *\n * Pipeline: plugins → onSend → transport.send → onSuccess / onError.\n */\nexport function createWhatsAppSender(config: WhatsAppSenderConfig): WhatsAppSender {\n  const { transport, plugins, hooks } = config;\n\n  return {\n    async send(options: WhatsAppOptions): Promise<WhatsAppSendResult> {\n      const processed = await runPlugins(options, plugins);\n      const ctx = buildWhatsAppHookContext(processed, transport);\n\n      await invokeHook(hooks?.onSend, ctx);\n\n      const start = performance.now();\n\n      try {\n        const result = await transport.send(processed);\n        const successCtx: WhatsAppHookContext = {\n          ...ctx,\n          messageId: result.messageId,\n        };\n        await invokeHook(hooks?.onSuccess, successCtx, result, performance.now() - start);\n        return result;\n      } catch (error) {\n        await invokeHook(hooks?.onError, ctx, error, performance.now() - start);\n        throw error;\n      }\n    },\n\n    async verify(): Promise<VerifyResult> {\n      if (transport.verify) {\n        return transport.verify();\n      }\n      return { ok: true, provider: \"whatsapp\" };\n    },\n\n    async close(): Promise<void> {\n      if (transport.close) {\n        await transport.close();\n      }\n    },\n  };\n}\n"
+  ],
+  "mappings": "iFAuDA,GAAS,CAAwB,CAC/B,EACA,EACqB,CACrB,MAAO,IACD,EAAQ,YAAc,OAAY,CAAE,UAAW,EAAQ,SAAU,EAAI,CAAC,EAC1E,GAAI,EAAQ,GACZ,SAAU,EAAU,UAAY,UAClC,EAQK,SAAS,CAAoB,CAAC,EAA8C,CACjF,IAAQ,YAAW,UAAS,SAAU,EAEtC,MAAO,MACC,KAAI,CAAC,EAAuD,CAChE,IAAM,EAAY,MAAM,EAAW,EAAS,CAAO,EAC7C,EAAM,EAAyB,EAAW,CAAS,EAEzD,MAAM,EAAW,GAAO,OAAQ,CAAG,EAEnC,IAAM,EAAQ,YAAY,IAAI,EAE9B,GAAI,CACF,IAAM,EAAS,MAAM,EAAU,KAAK,CAAS,EACvC,EAAkC,IACnC,EACH,UAAW,EAAO,SACpB,EAEA,OADA,MAAM,EAAW,GAAO,UAAW,EAAY,EAAQ,YAAY,IAAI,EAAI,CAAK,EACzE,EACP,MAAO,EAAO,CAEd,MADA,MAAM,EAAW,GAAO,QAAS,EAAK,EAAO,YAAY,IAAI,EAAI,CAAK,EAChE,SAIJ,OAAM,EAA0B,CACpC,GAAI,EAAU,OACZ,OAAO,EAAU,OAAO,EAE1B,MAAO,CAAE,GAAI,GAAM,SAAU,UAAW,QAGpC,MAAK,EAAkB,CAC3B,GAAI,EAAU,MACZ,MAAM,EAAU,MAAM,EAG5B",
+  "debugId": "A4F982D22B2A1BB164756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sently",
-  "version": "0.8.0",
-  "description": "Runtime-agnostic email library for Node.js, Bun, Deno, and Cloudflare Workers. ESM-native Nodemailer alternative with zero dependencies.",
+  "version": "0.9.1",
+  "description": "Runtime-agnostic messaging library for Node.js, Bun, Deno, and Cloudflare Workers. Channel-first email, SMS, WhatsApp, and push with pluggable provider transports.",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -10,12 +10,17 @@
     "dist",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "AGENTS.md",
+    "site/content/docs"
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "workspaces": [
+    "site"
+  ],
   "scripts": {
     "build": "bun run build.ts",
     "test": "bun test",
@@ -24,6 +29,8 @@
     "format": "biome format src --write",
     "typecheck": "tsc --noEmit",
     "mcp": "bun tools/mcp/index.ts",
+    "site:dev": "bun run --cwd site dev",
+    "site:build": "bun run --cwd site build",
     "verify": "bun run lint && bun run typecheck && bun run build && bun test",
     "prepack": "bun run verify",
     "pack:npm": "npm pack --dry-run --cache ./.npm-cache",
@@ -36,12 +43,14 @@
     "verify:publish": "bun run pack:npm",
     "measure:size": "bun tools/measure-bundle-size.ts",
     "measure:size:md": "bun tools/measure-bundle-size.ts --markdown",
-    "check:size": "bun tools/measure-bundle-size.ts --check"
+    "check:size": "bun tools/measure-bundle-size.ts --check",
+    "g": "gflows"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.16",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@react-email/render": "1.1.2",
+    "gflows": "1.2.1",
     "@types/node": "25.9.1",
     "@types/react": "19.2.15",
     "react": "19.2.6",
@@ -174,6 +183,38 @@
       "import": "./dist/transports/loops.js",
       "types": "./dist/transports/loops.d.ts"
     },
+    "./transports/sndr": {
+      "import": "./dist/transports/sndr.js",
+      "types": "./dist/transports/sndr.d.ts"
+    },
+    "./transports/twilio-sms": {
+      "import": "./dist/transports/twilio-sms.js",
+      "types": "./dist/transports/twilio-sms.d.ts"
+    },
+    "./transports/taqnyat-sms": {
+      "import": "./dist/transports/taqnyat-sms.js",
+      "types": "./dist/transports/taqnyat-sms.d.ts"
+    },
+    "./transports/taqnyat-whatsapp": {
+      "import": "./dist/transports/taqnyat-whatsapp.js",
+      "types": "./dist/transports/taqnyat-whatsapp.d.ts"
+    },
+    "./transports/taqnyat-mail": {
+      "import": "./dist/transports/taqnyat-mail.js",
+      "types": "./dist/transports/taqnyat-mail.d.ts"
+    },
+    "./transports/msegat": {
+      "import": "./dist/transports/msegat.js",
+      "types": "./dist/transports/msegat.d.ts"
+    },
+    "./transports/whatsapp-cloud": {
+      "import": "./dist/transports/whatsapp-cloud.js",
+      "types": "./dist/transports/whatsapp-cloud.d.ts"
+    },
+    "./transports/webpush": {
+      "import": "./dist/transports/webpush.js",
+      "types": "./dist/transports/webpush.d.ts"
+    },
     "./observability": {
       "import": "./dist/observability/console.js",
       "types": "./dist/observability/console.d.ts"
@@ -194,6 +235,18 @@
       "import": "./dist/mailer.js",
       "types": "./dist/mailer.d.ts"
     },
+    "./sms": {
+      "import": "./dist/sms.js",
+      "types": "./dist/sms.d.ts"
+    },
+    "./whatsapp": {
+      "import": "./dist/whatsapp.js",
+      "types": "./dist/whatsapp.d.ts"
+    },
+    "./push": {
+      "import": "./dist/push.js",
+      "types": "./dist/push.d.ts"
+    },
     "./smtp": {
       "import": "./dist/smtp-mailer.js",
       "types": "./dist/smtp-mailer.d.ts"
@@ -214,6 +267,34 @@
       "import": "./dist/webhooks.js",
       "types": "./dist/webhooks.d.ts"
     },
+    "./webhooks/brevo": {
+      "import": "./dist/webhooks/brevo.js",
+      "types": "./dist/webhooks/brevo.d.ts"
+    },
+    "./webhooks/mailgun": {
+      "import": "./dist/webhooks/mailgun.js",
+      "types": "./dist/webhooks/mailgun.d.ts"
+    },
+    "./webhooks/postmark": {
+      "import": "./dist/webhooks/postmark.js",
+      "types": "./dist/webhooks/postmark.d.ts"
+    },
+    "./webhooks/resend": {
+      "import": "./dist/webhooks/resend.js",
+      "types": "./dist/webhooks/resend.d.ts"
+    },
+    "./webhooks/sendgrid": {
+      "import": "./dist/webhooks/sendgrid.js",
+      "types": "./dist/webhooks/sendgrid.d.ts"
+    },
+    "./webhooks/ses": {
+      "import": "./dist/webhooks/ses.js",
+      "types": "./dist/webhooks/ses.d.ts"
+    },
+    "./webhooks/sndr": {
+      "import": "./dist/webhooks/sndr.js",
+      "types": "./dist/webhooks/sndr.d.ts"
+    },
     "./errors": {
       "import": "./dist/errors.js",
       "types": "./dist/errors.d.ts"

package/site/README.md

@@ -0,0 +1,26 @@
+# sently docs site
+
+Next.js + [Fumadocs](https://fumadocs.dev) documentation site.
+
+- Handbook content lives under `content/docs/`.
+- **Changelog** (`/changelog`) is derived from the root `CHANGELOG.md`.
+
+## Commands
+
+```bash
+bun run dev           # Next development server
+bun run build         # static export → out/
+bun run start         # serve out/
+```
+
+From the monorepo root:
+
+```bash
+bun run site:dev
+bun run site:build
+```
+
+## Deployment
+
+`next.config.mjs` sets `output: 'export'`. The build produces a static `out/`
+directory — host it anywhere.

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

@@ -0,0 +1,13 @@
+---
+title: AI integration
+description: Machine-readable documentation and the local MCP server.
+icon: FolderOpen
+source: "README.md"
+---
+
+Machine-readable documentation and the local MCP server.
+
+<Cards>
+  <Card title="llms.txt" href="/docs/ai/llms-txt" />
+  <Card title="MCP" href="/docs/ai/mcp" />
+</Cards>

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

@@ -0,0 +1,12 @@
+---
+title: llms.txt
+description: Use the docs site machine-readable indexes for agent context.
+icon: FileText
+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 `/llms.txt` for navigation and `/llms-full.txt` when an agent needs page content.
+
+<Cards><Card title="MCP" href="/docs/ai/mcp" /></Cards>

package/site/content/docs/ai/mcp.mdx

@@ -0,0 +1,16 @@
+---
+title: MCP
+description: Run the local Model Context Protocol server for sently tooling.
+icon: Server
+source: "tools/mcp/index.ts"
+---
+
+The repository exposes a local MCP server through the `bun run mcp` script.
+
+```bash
+bun run mcp
+```
+
+Consult the server tool descriptions after connecting; only invoke tools that the connected server advertises.
+
+<Cards><Card title="llms.txt" href="/docs/ai/llms-txt" /></Cards>

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

@@ -0,0 +1,9 @@
+{
+  "title": "AI",
+  "icon": "Bot",
+  "pages": [
+    "index",
+    "llms-txt",
+    "mcp"
+  ]
+}

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

@@ -0,0 +1,100 @@
+---
+title: Email
+description: Compose and deliver email through a mailer and a transport.
+icon: Mail
+source: "src/mailer.ts"
+---
+
+Use the email channel for receipts, invitations, and other messages sent by your application.
+A mailer owns the send pipeline; a transport delivers each message through SMTP or an email API.
+
+<Callout title="The one rule">Create the mailer once with a transport, then `await` `createMailer` before sending.</Callout>
+
+<Steps>
+  <Step title="Create a transport-backed mailer">
+
+```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!,
+  }),
+});
+```
+
+  </Step>
+  <Step title="Send an email">
+
+```ts
+const result = await mailer.send({
+  from: "Acme <hello@example.com>",
+  to: "person@example.com",
+  subject: "Welcome",
+  text: "Thanks for joining Acme.",
+});
+
+console.log(result.messageId);
+```
+
+  </Step>
+</Steps>
+
+## Mailer configuration
+
+| Option | Type | Meaning |
+| --- | --- | --- |
+| `transport` | `Transport` | Required delivery implementation, such as `ResendTransport`. |
+| `plugins` | `MailPlugin[]` | Optional transforms run before delivery. |
+| `hooks` | `MailerHooks` | Optional callbacks for send activity. |
+
+## Message options
+
+| Option | Type | Meaning |
+| --- | --- | --- |
+| `from` | `AddressInput` | Required sender address. |
+| `to` | `AddressInput` | Required recipient or recipients. |
+| `subject` | `string` | Required message subject. |
+| `text` / `html` | `string` | Plain-text or HTML body. |
+| `attachments` | `Attachment[]` | Optional in-memory or supported-runtime file attachments. |
+| `cc`, `bcc`, `replyTo` | `AddressInput` | Optional recipient fields. |
+
+For SMTP relay configuration, use the asynchronous `createSMTPMailer` factory instead.
+
+```ts
+import { createSMTPMailer } from "sently/smtp";
+
+const mailer = await createSMTPMailer({
+  host: "smtp.example.com",
+  port: 587,
+  auth: { user: "you@example.com", pass: process.env.SMTP_PASSWORD! },
+});
+```
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Why does createMailer reject host and port?">
+    `createMailer` only accepts an explicit transport. Use `createSMTPMailer` when your configuration starts with an SMTP host and port.
+  </Accordion>
+  <Accordion title="Can I change email providers?">
+    Yes. Keep calls to `mailer.send` and create the mailer with a different email transport.
+  </Accordion>
+  <Accordion title="What does verify do?">
+    `mailer.verify()` delegates to the transport when it provides `verify`; otherwise it reports a successful mailer result.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Email options](../reference/mail-options)
+- [Transport contracts](../reference/transport-contracts)
+- [Hooks](./hooks)
+
+## Next
+
+<Cards>
+  <Card title="Transports" href="/docs/transports" />
+  <Card title="Send in bulk" href="/docs/guides/send-bulk" />
+</Cards>

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

@@ -0,0 +1,87 @@
+---
+title: Lifecycle hooks
+description: Observe sender activity without putting message bodies in hook context.
+icon: Activity
+source: "src/core/hooks.ts"
+---
+
+Hooks observe sends for metrics and tracing without coupling your application to a provider.
+Their contexts include delivery metadata, not a message body.
+
+<Callout title="The one rule">Do not log message bodies in hooks; their contexts intentionally expose only delivery metadata.</Callout>
+
+<Steps>
+  <Step title="Configure hooks when creating the 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!,
+  }),
+  hooks: {
+    onSuccess: ({ provider, subject, to }, result, durationMs) => {
+      console.log(provider, subject, result.messageId, durationMs);
+      console.log(to);
+    },
+  },
+});
+```
+
+  </Step>
+  <Step title="Send normally">
+
+```ts
+await mailer.send({
+  from: "hello@example.com",
+  to: "person@example.com",
+  subject: "Welcome",
+  text: "Thanks for joining.",
+});
+```
+
+  </Step>
+</Steps>
+
+## Hook callbacks
+
+| Channel | Callbacks | Context |
+| --- | --- | --- |
+| Email | `onSend`, `onSuccess`, `onError`, `onRetry`, `onFallback` | `messageId`, recipients, subject, provider. |
+| SMS | `onSend`, `onSuccess`, `onError` | `messageId`, recipient number, provider. |
+| WhatsApp | `onSend`, `onSuccess`, `onError` | `messageId`, recipient number, provider. |
+| Push | `onSend`, `onSuccess`, `onError` | `messageId`, redacted endpoint, provider. |
+
+`onSuccess` receives the delivery result and optional duration in milliseconds. `onError` receives the error and optional duration.
+
+## Retry and fallback
+
+Email `onRetry` runs only with `RetryTransport`. Email `onFallback` runs only with a fallback transport; both are configured as decorators around an email transport.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Why does onRetry not run?">
+    `onRetry` is wired only when the mailer's transport is `RetryTransport`.
+  </Accordion>
+  <Accordion title="Why does my hook error not stop the send?">
+    Hook failures are intentionally swallowed so observability code cannot break message delivery.
+  </Accordion>
+  <Accordion title="Why is a push endpoint redacted?">
+    The endpoint path can contain a long-lived delivery token and is not exposed in full to hooks.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Email channel](./email)
+- [Observability](../guides/observability)
+
+## Next
+
+<Cards>
+  <Card title="Observability" href="/docs/guides/observability" />
+  <Card title="Retry" href="/docs/decorators/retry" />
+</Cards>