sently 0.7.2 → 0.9.0

package/dist/sms.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/sms.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * SMS sender orchestrator — plugins, hooks, and transport.send pipeline.\n *\n * Sently-first: apps call {@link createSmsSender}; providers implement\n * {@link SmsTransport}. Vendor-only extras stay on the concrete transport.\n *\n * @example\n * ```ts\n * import { createSmsSender } from \"sently/sms\";\n * import { TwilioSmsTransport } from \"sently/transports/twilio-sms\";\n *\n * const sms = createSmsSender({\n *   transport: new TwilioSmsTransport({ accountSid: \"...\", authToken: \"...\" }),\n * });\n *\n * await sms.send({ to: \"+15551234567\", body: \"Hello\", from: \"+15557654321\" });\n * ```\n */\nimport { invokeHook } from \"./core/hooks.js\";\nimport { runPlugins } from \"./core/plugin.js\";\nimport type {\n  SmsHookContext,\n  SmsHooks,\n  SmsOptions,\n  SmsPlugin,\n  SmsSendResult,\n  SmsTransport,\n} from \"./core/sms-types.js\";\nimport type { VerifyResult } from \"./core/types.js\";\n\n/** Configuration for {@link createSmsSender}. */\nexport interface SmsSenderConfig {\n  /** SMS delivery transport. */\n  transport: SmsTransport;\n  /** Optional plugins run before each send. */\n  plugins?: SmsPlugin[];\n  /** Optional lifecycle hooks for metrics and tracing. */\n  hooks?: SmsHooks;\n}\n\n/** SMS sender returned by {@link createSmsSender}. */\nexport interface SmsSender {\n  /** Send an SMS through the configured transport. */\n  send(options: SmsOptions): Promise<SmsSendResult>;\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 buildSmsHookContext(options: SmsOptions, transport: SmsTransport): SmsHookContext {\n  return {\n    ...(options.messageId !== undefined ? { messageId: options.messageId } : {}),\n    to: options.to,\n    provider: transport.provider ?? \"sms\",\n  };\n}\n\n/**\n * Create an SMS sender that wraps an {@link SmsTransport}.\n *\n * Pipeline: plugins → onSend → transport.send → onSuccess / onError.\n */\nexport function createSmsSender(config: SmsSenderConfig): SmsSender {\n  const { transport, plugins, hooks } = config;\n\n  return {\n    async send(options: SmsOptions): Promise<SmsSendResult> {\n      const processed = await runPlugins(options, plugins);\n      const ctx = buildSmsHookContext(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: SmsHookContext = {\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: \"sms\" };\n    },\n\n    async close(): Promise<void> {\n      if (transport.close) {\n        await transport.close();\n      }\n    },\n  };\n}\n"
+  ],
+  "mappings": "iFAmDA,GAAS,CAAmB,CAAC,EAAqB,EAAyC,CACzF,MAAO,IACD,EAAQ,YAAc,OAAY,CAAE,UAAW,EAAQ,SAAU,EAAI,CAAC,EAC1E,GAAI,EAAQ,GACZ,SAAU,EAAU,UAAY,KAClC,EAQK,SAAS,CAAe,CAAC,EAAoC,CAClE,IAAQ,YAAW,UAAS,SAAU,EAEtC,MAAO,MACC,KAAI,CAAC,EAA6C,CACtD,IAAM,EAAY,MAAM,EAAW,EAAS,CAAO,EAC7C,EAAM,EAAoB,EAAW,CAAS,EAEpD,MAAM,EAAW,GAAO,OAAQ,CAAG,EAEnC,IAAM,EAAQ,YAAY,IAAI,EAE9B,GAAI,CACF,IAAM,EAAS,MAAM,EAAU,KAAK,CAAS,EACvC,EAA6B,IAC9B,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,KAAM,QAG/B,MAAK,EAAkB,CAC3B,GAAI,EAAU,MACZ,MAAM,EAAU,MAAM,EAG5B",
+  "debugId": "9AD22B10712186FC64756E2164756E21",
+  "names": []
+}

package/dist/smtp-mailer.js

@@ -1,3 +1,3 @@
-import{u as g}from"./chunk-74rha3ac.js";import{w as k}from"./chunk-ka6t8g77.js";import"./chunk-kebhy657.js";import"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import"./chunk-a1c87hn1.js";import{W as v}from"./chunk-keksa6fx.js";async function F(b){let q={...b.secure!==void 0?{secure:b.secure}:{},...b.connectionTimeout!==void 0?{connectionTimeout:b.connectionTimeout}:{},...b.tls!==void 0?{tls:b.tls}:{}};if(b.pool){let{SMTPPool:z}=await import("./pool/pool.js");return new k(new z(b,{createAdapter:async()=>b.adapter??await g(q)}),b.plugins,b.hooks)}let w=b.adapter??await g(q),{SMTPTransport:x}=await import("./transports/smtp.js");return new k(new x({...b,adapter:w}),b.plugins,b.hooks)}export{F as createSMTPMailer};
+import{K as g}from"./chunk-29z7fkzy.js";import{M as k}from"./chunk-5915vbcj.js";import"./chunk-gp4fwrs8.js";import"./chunk-0qxws3kj.js";import"./chunk-93vqxxj2.js";import"./chunk-qtkd5bak.js";import"./chunk-ywq6s10g.js";import"./chunk-tamww15j.js";import{fa as v}from"./chunk-6npp3x3c.js";async function F(b){let q={...b.secure!==void 0?{secure:b.secure}:{},...b.connectionTimeout!==void 0?{connectionTimeout:b.connectionTimeout}:{},...b.tls!==void 0?{tls:b.tls}:{}};if(b.pool){let{SMTPPool:z}=await import("./pool/pool.js");return new k(new z(b,{createAdapter:async()=>b.adapter??await g(q)}),b.plugins,b.hooks)}let w=b.adapter??await g(q),{SMTPTransport:x}=await import("./transports/smtp.js");return new k(new x({...b,adapter:w}),b.plugins,b.hooks)}export{F as createSMTPMailer};
 
-//# debugId=A5A864CB09BE2C3364756E2164756E21
+//# debugId=DE7394EDE2CB853864756E2164756E21

package/dist/smtp-mailer.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "/**\n * @module\n * SMTP-capable mailer factory — host/port config, pooling, and runtime adapters.\n *\n * Import from `sently/smtp` or use {@link createSMTPMailer} from the main package.\n * For HTTP transports, use `sently/mailer` instead (~10 KB smaller in app bundles).\n *\n * @example\n * ```ts\n * import { createSMTPMailer } from \"sently/smtp\";\n *\n * const mailer = await createSMTPMailer({\n *   host: \"smtp.example.com\",\n *   port: 587,\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { Mailer, SMTPMailerOptions } from \"./core/types.js\";\nimport { createDefaultAdapter } from \"./detect.js\";\nimport { MailerImpl } from \"./mailer.js\";\n\n/**\n * Create a mailer from SMTP relay options (host, port, auth, pool, adapter).\n */\nexport async function createSMTPMailer(options: SMTPMailerOptions): Promise<Mailer> {\n  const adapterOptions = {\n    ...(options.secure !== undefined ? { secure: options.secure } : {}),\n    ...(options.connectionTimeout !== undefined\n      ? { connectionTimeout: options.connectionTimeout }\n      : {}),\n    ...(options.tls !== undefined ? { tls: options.tls } : {}),\n  };\n\n  if (options.pool) {\n    const { SMTPPool } = await import(\"./pool/pool.js\");\n    return new MailerImpl(\n      new SMTPPool(options, {\n        createAdapter: async () => options.adapter ?? (await createDefaultAdapter(adapterOptions)),\n      }),\n      options.plugins,\n      options.hooks,\n    );\n  }\n\n  const adapter = options.adapter ?? (await createDefaultAdapter(adapterOptions));\n  const { SMTPTransport } = await import(\"./transports/smtp.js\");\n\n  return new MailerImpl(new SMTPTransport({ ...options, adapter }), options.plugins, options.hooks);\n}\n"
   ],
-  "mappings": "4QAyBA,SAAsB,LAAgB,LAAC,JAA6C,LAClF,FAAM,EAAiB,IACjB,EAAQ,SAAW,OAAY,CAAE,OAAQ,EAAQ,MAAO,EAAI,CAAC,KAC7D,EAAQ,oBAAsB,OAC9B,CAAE,kBAAmB,EAAQ,iBAAkB,EAC/C,CAAC,KACD,EAAQ,MAAQ,OAAY,CAAE,IAAK,EAAQ,GAAI,EAAI,CAAC,CAC1D,EAEA,GAAI,EAAQ,KAAM,CAChB,IAAQ,YAAa,KAAa,0BAClC,OAAO,IAAI,EACT,IAAI,EAAS,EAAS,CACpB,cAAe,SAAY,EAAQ,SAAY,MAAM,EAAqB,CAAc,CAC1F,CAAC,EACD,EAAQ,QACR,EAAQ,KACV,EAGF,IAAM,EAAU,EAAQ,SAAY,MAAM,EAAqB,CAAc,GACrE,iBAAkB,KAAa,gCAEvC,OAAO,IAAI,EAAW,IAAI,EAAc,IAAK,EAAS,SAAQ,CAAC,EAAG,EAAQ,QAAS,EAAQ,KAAK",
-  "debugId": "A5A864CB09BE2C3364756E2164756E21",
+  "mappings": "iVAyBA,SAAsB,LAAgB,LAAC,JAA6C,LAClF,FAAM,JAAiB,FACjB,EAAQ,SAAW,OAAY,CAAE,OAAQ,EAAQ,MAAO,EAAI,CAAC,KAC7D,EAAQ,oBAAsB,OAC9B,CAAE,kBAAmB,EAAQ,iBAAkB,EAC/C,CAAC,KACD,EAAQ,MAAQ,OAAY,CAAE,IAAK,EAAQ,GAAI,EAAI,CAAC,CAC1D,EAEA,GAAI,EAAQ,KAAM,CAChB,IAAQ,YAAa,KAAa,0BAClC,OAAO,IAAI,EACT,IAAI,EAAS,EAAS,CACpB,cAAe,SAAY,EAAQ,SAAY,MAAM,EAAqB,CAAc,CAC1F,CAAC,EACD,EAAQ,QACR,EAAQ,KACV,EAGF,IAAM,EAAU,EAAQ,SAAY,MAAM,EAAqB,CAAc,GACrE,iBAAkB,KAAa,gCAEvC,OAAO,IAAI,EAAW,IAAI,EAAc,IAAK,EAAS,SAAQ,CAAC,EAAG,EAAQ,QAAS,EAAQ,KAAK",
+  "debugId": "DE7394EDE2CB853864756E2164756E21",
   "names": []
 }

package/dist/transports/brevo.d.ts

@@ -10,6 +10,7 @@ export declare class BrevoError extends SentlyError {
  * Brevo HTTP API transport.
  */
 export declare class BrevoTransport implements Transport {
+    readonly provider = "brevo";
     /** Brevo API key used for Authorization. */
     private readonly apiKey;
     /** Creates a Brevo transport with the given API key. */

package/dist/transports/brevo.js

@@ -1,3 +1,3 @@
-import{s as R}from"../chunk-r7ee9tk7.js";import{B as M,z as G}from"../chunk-gh5n759p.js";import{P as L}from"../chunk-d5rwm3br.js";import{T as N,U as Q}from"../chunk-a1c87hn1.js";import"../chunk-keksa6fx.js";class U extends N{statusCode;constructor(q,w,D){super(q,Q(w),{statusCode:w,provider:"brevo"});this.statusCode=w;this.name="BrevoError",this.code=D}}function J(q){return G(q).map((w)=>({email:w.address,...w.name?{name:w.name}:{}}))}class X{apiKey;constructor(q){this.apiKey=q.apiKey}async send(q){let w=await R(q.attachments),D=G(q.from)[0],W={sender:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},to:J(q.to),subject:q.subject,...q.cc?{cc:J(q.cc)}:{},...q.bcc?{bcc:J(q.bcc)}:{},...q.replyTo?{replyTo:(()=>{let z=G(q.replyTo)[0];return z?{email:z.address,...z.name?{name:z.name}:{}}:void 0})()}:{},...q.html?{htmlContent:q.html}:{},...q.text?{textContent:q.text}:{},...w.length>0?{attachment:w.map((z)=>({name:z.filename,content:z.content instanceof Uint8Array?L(z.content).replace(/\r\n/g,""):z.content}))}:{}},H=await fetch("https://api.brevo.com/v3/smtp/email",{method:"POST",headers:{"api-key":this.apiKey,"Content-Type":"application/json"},body:JSON.stringify(W)}),F=await H.json();if(!H.ok)throw new U(F.message??"Brevo API error",H.status,F.code??"");let K=M(q.to);return{messageId:F.messageId??"",accepted:K,rejected:[],response:F.messageId??"sent",envelope:{from:D?.address??"",to:K}}}async verify(){try{let q=await fetch("https://api.brevo.com/v3/account",{headers:{"api-key":this.apiKey}}),w=await q.json();if(!q.ok)return{ok:!1,provider:"brevo",message:w.message??`HTTP ${q.status}`};return{ok:!0,provider:"brevo",...w.companyName?{message:w.companyName}:{}}}catch(q){return{ok:!1,provider:"brevo",message:q instanceof Error?q.message:String(q)}}}}export{X as BrevoTransport,U as BrevoError};
+import{I as R}from"../chunk-skqhj0rm.js";import{Q as G,S as M}from"../chunk-93vqxxj2.js";import{Y as L}from"../chunk-ywq6s10g.js";import{ca as N,da as Q}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class U extends N{statusCode;constructor(q,w,D){super(q,Q(w),{statusCode:w,provider:"brevo"});this.statusCode=w;this.name="BrevoError",this.code=D}}function J(q){return G(q).map((w)=>({email:w.address,...w.name?{name:w.name}:{}}))}class X{provider="brevo";apiKey;constructor(q){this.apiKey=q.apiKey}async send(q){let w=await R(q.attachments),D=G(q.from)[0],W={sender:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},to:J(q.to),subject:q.subject,...q.cc?{cc:J(q.cc)}:{},...q.bcc?{bcc:J(q.bcc)}:{},...q.replyTo?{replyTo:(()=>{let z=G(q.replyTo)[0];return z?{email:z.address,...z.name?{name:z.name}:{}}:void 0})()}:{},...q.html?{htmlContent:q.html}:{},...q.text?{textContent:q.text}:{},...w.length>0?{attachment:w.map((z)=>({name:z.filename,content:z.content instanceof Uint8Array?L(z.content).replace(/\r\n/g,""):z.content}))}:{}},H=await fetch("https://api.brevo.com/v3/smtp/email",{method:"POST",headers:{"api-key":this.apiKey,"Content-Type":"application/json"},body:JSON.stringify(W)}),F=await H.json();if(!H.ok)throw new U(F.message??"Brevo API error",H.status,F.code??"");let K=M(q.to);return{messageId:F.messageId??"",accepted:K,rejected:[],response:F.messageId??"sent",envelope:{from:D?.address??"",to:K}}}async verify(){try{let q=await fetch("https://api.brevo.com/v3/account",{headers:{"api-key":this.apiKey}}),w=await q.json();if(!q.ok)return{ok:!1,provider:"brevo",message:w.message??`HTTP ${q.status}`};return{ok:!0,provider:"brevo",...w.companyName?{message:w.companyName}:{}}}catch(q){return{ok:!1,provider:"brevo",message:q instanceof Error?q.message:String(q)}}}}export{X as BrevoTransport,U as BrevoError};
 
-//# debugId=2FDD13CA0A66D5BE64756E2164756E21
+//# debugId=E4625E2F9F65354364756E2164756E21

package/dist/transports/brevo.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/transports/brevo.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Brevo (formerly Sendinblue) HTTP transport for sently.\n *\n * @example\n * ```ts\n * import { BrevoTransport } from \"sently/transports/brevo\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new BrevoTransport({ apiKey: \"xkeysib-...\" }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type {\n  BrevoConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Brevo API returns a non-success response. */\nexport class BrevoError extends SentlyError {\n  /** Creates a Brevo API error with status code and error code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    apiCode: string,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"brevo\",\n    });\n    this.name = \"BrevoError\";\n    this.code = apiCode;\n  }\n}\n\nfunction toAddressObjects(input: MailOptions[\"to\"]): Array<{ email: string; name?: string }> {\n  return parseAddresses(input).map((addr) => ({\n    email: addr.address,\n    ...(addr.name ? { name: addr.name } : {}),\n  }));\n}\n\n/**\n * Brevo HTTP API transport.\n */\nexport class BrevoTransport implements Transport {\n  /** Brevo API key used for Authorization. */\n  private readonly apiKey: string;\n\n  /** Creates a Brevo transport with the given API key. */\n  constructor(config: BrevoConfig) {\n    this.apiKey = config.apiKey;\n  }\n\n  /** Sends an email via the Brevo HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body: Record<string, unknown> = {\n      sender: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      to: toAddressObjects(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: toAddressObjects(options.cc) } : {}),\n      ...(options.bcc ? { bcc: toAddressObjects(options.bcc) } : {}),\n      ...(options.replyTo\n        ? {\n            replyTo: (() => {\n              const reply = parseAddresses(options.replyTo as MailOptions[\"to\"])[0];\n              return reply\n                ? { email: reply.address, ...(reply.name ? { name: reply.name } : {}) }\n                : undefined;\n            })(),\n          }\n        : {}),\n      ...(options.html ? { htmlContent: options.html } : {}),\n      ...(options.text ? { textContent: options.text } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachment: attachments.map((att) => ({\n              name: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.brevo.com/v3/smtp/email\", {\n      method: \"POST\",\n      headers: {\n        \"api-key\": this.apiKey,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      messageId?: string;\n      message?: string;\n      code?: string;\n    };\n\n    if (!response.ok) {\n      throw new BrevoError(\n        payload.message ?? \"Brevo API error\",\n        response.status,\n        payload.code ?? \"\",\n      );\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.messageId ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.messageId ?? \"sent\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Brevo API key by fetching account info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.brevo.com/v3/account\", {\n        headers: {\n          \"api-key\": this.apiKey,\n        },\n      });\n\n      const payload = (await response.json()) as { companyName?: string; message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"brevo\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"brevo\",\n        ...(payload.companyName ? { message: payload.companyName } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"brevo\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+    "/**\n * @module\n * Brevo (formerly Sendinblue) HTTP transport for sently.\n *\n * @example\n * ```ts\n * import { BrevoTransport } from \"sently/transports/brevo\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new BrevoTransport({ apiKey: \"xkeysib-...\" }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type {\n  BrevoConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Brevo API returns a non-success response. */\nexport class BrevoError extends SentlyError {\n  /** Creates a Brevo API error with status code and error code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    apiCode: string,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"brevo\",\n    });\n    this.name = \"BrevoError\";\n    this.code = apiCode;\n  }\n}\n\nfunction toAddressObjects(input: MailOptions[\"to\"]): Array<{ email: string; name?: string }> {\n  return parseAddresses(input).map((addr) => ({\n    email: addr.address,\n    ...(addr.name ? { name: addr.name } : {}),\n  }));\n}\n\n/**\n * Brevo HTTP API transport.\n */\nexport class BrevoTransport implements Transport {\n  readonly provider = \"brevo\";\n\n  /** Brevo API key used for Authorization. */\n  private readonly apiKey: string;\n\n  /** Creates a Brevo transport with the given API key. */\n  constructor(config: BrevoConfig) {\n    this.apiKey = config.apiKey;\n  }\n\n  /** Sends an email via the Brevo HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body: Record<string, unknown> = {\n      sender: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      to: toAddressObjects(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: toAddressObjects(options.cc) } : {}),\n      ...(options.bcc ? { bcc: toAddressObjects(options.bcc) } : {}),\n      ...(options.replyTo\n        ? {\n            replyTo: (() => {\n              const reply = parseAddresses(options.replyTo as MailOptions[\"to\"])[0];\n              return reply\n                ? { email: reply.address, ...(reply.name ? { name: reply.name } : {}) }\n                : undefined;\n            })(),\n          }\n        : {}),\n      ...(options.html ? { htmlContent: options.html } : {}),\n      ...(options.text ? { textContent: options.text } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachment: attachments.map((att) => ({\n              name: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.brevo.com/v3/smtp/email\", {\n      method: \"POST\",\n      headers: {\n        \"api-key\": this.apiKey,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      messageId?: string;\n      message?: string;\n      code?: string;\n    };\n\n    if (!response.ok) {\n      throw new BrevoError(\n        payload.message ?? \"Brevo API error\",\n        response.status,\n        payload.code ?? \"\",\n      );\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.messageId ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.messageId ?? \"sent\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Brevo API key by fetching account info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.brevo.com/v3/account\", {\n        headers: {\n          \"api-key\": this.apiKey,\n        },\n      });\n\n      const payload = (await response.json()) as { companyName?: string; message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"brevo\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"brevo\",\n        ...(payload.companyName ? { message: payload.companyName } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"brevo\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
   ],
-  "mappings": "mOA2BO,CAAM,KAAmB,JAAY,JAIxB,WAFlB,WAAW,CACT,EACgB,EAChB,EACA,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,OACZ,CAAC,EANe,kBAOhB,KAAK,KAAO,aACZ,KAAK,KAAO,EAEhB,CAEA,SAAS,CAAgB,CAAC,EAAmE,CAC3F,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC,KAAU,CAC1C,MAAO,EAAK,WACR,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CACzC,EAAE,EAMG,MAAM,CAAoC,CAE9B,OAGjB,WAAW,CAAC,EAAqB,CAC/B,KAAK,OAAS,EAAO,YAIjB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAO,EAAe,EAAQ,IAAI,EAAE,GAEpC,EAAgC,CACpC,OAAQ,EACJ,CAAE,MAAO,EAAK,WAAa,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CAAG,EACjE,CAAE,MAAO,EAAG,EAChB,GAAI,EAAiB,EAAQ,EAAE,EAC/B,QAAS,EAAQ,WACb,EAAQ,GAAK,CAAE,GAAI,EAAiB,EAAQ,EAAE,CAAE,EAAI,CAAC,KACrD,EAAQ,IAAM,CAAE,IAAK,EAAiB,EAAQ,GAAG,CAAE,EAAI,CAAC,KACxD,EAAQ,QACR,CACE,SAAU,IAAM,CACd,IAAM,EAAQ,EAAe,EAAQ,OAA4B,EAAE,GACnE,OAAO,EACH,CAAE,MAAO,EAAM,WAAa,EAAM,KAAO,CAAE,KAAM,EAAM,IAAK,EAAI,CAAC,CAAG,EACpE,SACH,CACL,EACA,CAAC,KACD,EAAQ,KAAO,CAAE,YAAa,EAAQ,IAAK,EAAI,CAAC,KAChD,EAAQ,KAAO,CAAE,YAAa,EAAQ,IAAK,EAAI,CAAC,KAChD,EAAY,OAAS,EACrB,CACE,WAAY,EAAY,IAAI,CAAC,KAAS,CACpC,KAAM,EAAI,SACV,QACE,EAAI,mBAAmB,WACnB,EAAa,EAAI,OAAO,EAAE,QAAQ,QAAS,EAAE,EAC7C,EAAI,OACZ,EAAE,CACJ,EACA,CAAC,CACP,EAEM,EAAW,MAAM,MAAM,sCAAuC,CAClE,OAAQ,OACR,QAAS,CACP,UAAW,KAAK,OAChB,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAMrC,GAAI,CAAC,EAAS,GACZ,MAAM,IAAI,EACR,EAAQ,SAAW,kBACnB,EAAS,OACT,EAAQ,MAAQ,EAClB,EAGF,IAAM,EAAW,EAAc,EAAQ,EAAE,EACzC,MAAO,CACL,UAAW,EAAQ,WAAa,GAChC,SAAU,EACV,SAAU,CAAC,EACX,SAAU,EAAQ,WAAa,OAC/B,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,GAAI,CACN,CACF,OAII,OAAM,EAA0B,CACpC,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,mCAAoC,CAC/D,QAAS,CACP,UAAW,KAAK,MAClB,CACF,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAErC,GAAI,CAAC,EAAS,GACZ,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,EAAQ,SAAW,QAAQ,EAAS,QAC/C,EAGF,MAAO,CACL,GAAI,GACJ,SAAU,WACN,EAAQ,YAAc,CAAE,QAAS,EAAQ,WAAY,EAAI,CAAC,CAChE,EACA,MAAO,EAAK,CACZ,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,aAAe,MAAQ,EAAI,QAAU,OAAO,CAAG,CAC1D,GAGN",
-  "debugId": "2FDD13CA0A66D5BE64756E2164756E21",
+  "mappings": "qOA2BO,CAAM,KAAmB,JAAY,JAIxB,WAFlB,WAAW,CACT,EACgB,EAChB,EACA,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,OACZ,CAAC,EANe,kBAOhB,KAAK,KAAO,aACZ,KAAK,KAAO,EAEhB,CAEA,SAAS,CAAgB,CAAC,EAAmE,CAC3F,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC,KAAU,CAC1C,MAAO,EAAK,WACR,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CACzC,EAAE,EAMG,MAAM,CAAoC,CACtC,SAAW,QAGH,OAGjB,WAAW,CAAC,EAAqB,CAC/B,KAAK,OAAS,EAAO,YAIjB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAO,EAAe,EAAQ,IAAI,EAAE,GAEpC,EAAgC,CACpC,OAAQ,EACJ,CAAE,MAAO,EAAK,WAAa,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CAAG,EACjE,CAAE,MAAO,EAAG,EAChB,GAAI,EAAiB,EAAQ,EAAE,EAC/B,QAAS,EAAQ,WACb,EAAQ,GAAK,CAAE,GAAI,EAAiB,EAAQ,EAAE,CAAE,EAAI,CAAC,KACrD,EAAQ,IAAM,CAAE,IAAK,EAAiB,EAAQ,GAAG,CAAE,EAAI,CAAC,KACxD,EAAQ,QACR,CACE,SAAU,IAAM,CACd,IAAM,EAAQ,EAAe,EAAQ,OAA4B,EAAE,GACnE,OAAO,EACH,CAAE,MAAO,EAAM,WAAa,EAAM,KAAO,CAAE,KAAM,EAAM,IAAK,EAAI,CAAC,CAAG,EACpE,SACH,CACL,EACA,CAAC,KACD,EAAQ,KAAO,CAAE,YAAa,EAAQ,IAAK,EAAI,CAAC,KAChD,EAAQ,KAAO,CAAE,YAAa,EAAQ,IAAK,EAAI,CAAC,KAChD,EAAY,OAAS,EACrB,CACE,WAAY,EAAY,IAAI,CAAC,KAAS,CACpC,KAAM,EAAI,SACV,QACE,EAAI,mBAAmB,WACnB,EAAa,EAAI,OAAO,EAAE,QAAQ,QAAS,EAAE,EAC7C,EAAI,OACZ,EAAE,CACJ,EACA,CAAC,CACP,EAEM,EAAW,MAAM,MAAM,sCAAuC,CAClE,OAAQ,OACR,QAAS,CACP,UAAW,KAAK,OAChB,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAMrC,GAAI,CAAC,EAAS,GACZ,MAAM,IAAI,EACR,EAAQ,SAAW,kBACnB,EAAS,OACT,EAAQ,MAAQ,EAClB,EAGF,IAAM,EAAW,EAAc,EAAQ,EAAE,EACzC,MAAO,CACL,UAAW,EAAQ,WAAa,GAChC,SAAU,EACV,SAAU,CAAC,EACX,SAAU,EAAQ,WAAa,OAC/B,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,GAAI,CACN,CACF,OAII,OAAM,EAA0B,CACpC,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,mCAAoC,CAC/D,QAAS,CACP,UAAW,KAAK,MAClB,CACF,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAErC,GAAI,CAAC,EAAS,GACZ,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,EAAQ,SAAW,QAAQ,EAAS,QAC/C,EAGF,MAAO,CACL,GAAI,GACJ,SAAU,WACN,EAAQ,YAAc,CAAE,QAAS,EAAQ,WAAY,EAAI,CAAC,CAChE,EACA,MAAO,EAAK,CACZ,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,aAAe,MAAQ,EAAI,QAAU,OAAO,CAAG,CAC1D,GAGN",
+  "debugId": "E4625E2F9F65354364756E2164756E21",
   "names": []
 }

package/dist/transports/cloudflare-email.d.ts

@@ -0,0 +1,58 @@
+import { SentlyError } from "../core/errors.js";
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Message shape accepted by the Cloudflare Workers `send_email` binding. */
+export interface CloudflareEmailMessage {
+    /** Envelope sender. */
+    from: string;
+    /** Primary recipient. */
+    to: string;
+    /** Message subject. */
+    subject?: string;
+    /** Reply-To address. */
+    reply_to?: string;
+    /** Carbon-copy recipients. */
+    cc?: string[];
+    /** Blind carbon-copy recipients. */
+    bcc?: string[];
+    /** Additional MIME headers. */
+    headers?: Record<string, string>;
+    /** Message body parts. */
+    content: Array<{
+        type: string;
+        value: string;
+    }>;
+    /** Optional attachments (base64 content). */
+    attachments?: Array<{
+        disposition: "attachment" | "inline";
+        filename: string;
+        type: string;
+        content: string;
+    }>;
+}
+/** Callable Workers `send_email` binding. */
+export type CloudflareSendEmailFn = (message: CloudflareEmailMessage) => Promise<void>;
+/** Cloudflare Workers Email binding configuration. */
+export interface CloudflareEmailConfig {
+    /** The Workers `send_email` binding (e.g. `env.SEND_EMAIL`). */
+    sendEmail: CloudflareSendEmailFn;
+}
+/** Error thrown when the Cloudflare Email binding rejects a send. */
+export declare class CloudflareEmailError extends SentlyError {
+    /** Creates a Cloudflare Email binding error. */
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Cloudflare Workers Email binding transport.
+ */
+export declare class CloudflareEmailTransport implements Transport {
+    readonly provider = "cloudflare-email";
+    private readonly sendEmail;
+    /** Creates a transport backed by the Workers `send_email` binding. */
+    constructor(config: CloudflareEmailConfig);
+    /** Sends an email via the Workers `send_email` binding. */
+    send(options: MailOptions): Promise<SendResult>;
+    /**
+     * Confirms the binding is configured — no network validation is available.
+     */
+    verify(): Promise<VerifyResult>;
+}

package/dist/transports/cloudflare-email.js

@@ -0,0 +1,3 @@
+import{I as O}from"../chunk-skqhj0rm.js";import{Q as M,S as G}from"../chunk-93vqxxj2.js";import{Y as L}from"../chunk-ywq6s10g.js";import{ca as N}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class I extends N{constructor(q,D){super(q,"PROVIDER_ERROR",{provider:"cloudflare-email",cause:D});this.name="CloudflareEmailError"}}class Q{provider="cloudflare-email";sendEmail;constructor(q){this.sendEmail=q.sendEmail}async send(q){let D=M(q.from)[0],H=G(q.to),J=H[0];if(!D||!J)throw new I("Cloudflare Email requires from and to addresses");let F=[];if(q.text!==void 0)F.push({type:"text/plain",value:q.text});if(q.html!==void 0)F.push({type:"text/html",value:q.html});if(F.length===0)F.push({type:"text/plain",value:""});let K=await O(q.attachments),P={from:D.address,to:J,subject:q.subject,content:F,...q.replyTo?{reply_to:G(q.replyTo)[0]}:{},...q.cc?{cc:G(q.cc)}:{},...q.bcc?{bcc:G(q.bcc)}:{},...q.headers?{headers:q.headers}:{},...K.length>0?{attachments:K.map((z)=>({disposition:z.inline?"inline":"attachment",filename:z.filename,type:z.contentType??"application/octet-stream",content:z.content instanceof Uint8Array?L(z.content).replace(/\r\n/g,""):String(z.content??"")}))}:{}};try{await this.sendEmail(P)}catch(z){throw new I(z instanceof Error?z.message:"Cloudflare Email send failed",z)}return{messageId:q.messageId??"",accepted:H,rejected:[],response:"sent via Cloudflare Email binding",envelope:{from:D.address,to:H}}}async verify(){return{ok:!0,provider:"cloudflare-email",message:"send_email binding configured (not validated at runtime)"}}}export{Q as CloudflareEmailTransport,I as CloudflareEmailError};
+
+//# debugId=12AACAC7726534CE64756E2164756E21

package/dist/transports/cloudflare-email.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/cloudflare-email.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Cloudflare Workers Email transport — wraps the `send_email` binding\n * configured in `wrangler.toml`, not a fetch-based HTTP API.\n *\n * @example\n * ```ts\n * // wrangler.toml: [[send_email]]\n * import { CloudflareEmailTransport } from \"sently/transports/cloudflare-email\";\n * import { createMailer } from \"sently/mailer\";\n *\n * export default {\n *   async fetch(request, env) {\n *     const mailer = await createMailer({\n *       transport: new CloudflareEmailTransport({ sendEmail: env.SEND_EMAIL }),\n *     });\n *     await mailer.send({ from: \"...\", to: \"...\", subject: \"...\", text: \"...\" });\n *   },\n * };\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Message shape accepted by the Cloudflare Workers `send_email` binding. */\nexport interface CloudflareEmailMessage {\n  /** Envelope sender. */\n  from: string;\n  /** Primary recipient. */\n  to: string;\n  /** Message subject. */\n  subject?: string;\n  /** Reply-To address. */\n  reply_to?: string;\n  /** Carbon-copy recipients. */\n  cc?: string[];\n  /** Blind carbon-copy recipients. */\n  bcc?: string[];\n  /** Additional MIME headers. */\n  headers?: Record<string, string>;\n  /** Message body parts. */\n  content: Array<{ type: string; value: string }>;\n  /** Optional attachments (base64 content). */\n  attachments?: Array<{\n    disposition: \"attachment\" | \"inline\";\n    filename: string;\n    type: string;\n    content: string;\n  }>;\n}\n\n/** Callable Workers `send_email` binding. */\nexport type CloudflareSendEmailFn = (message: CloudflareEmailMessage) => Promise<void>;\n\n/** Cloudflare Workers Email binding configuration. */\nexport interface CloudflareEmailConfig {\n  /** The Workers `send_email` binding (e.g. `env.SEND_EMAIL`). */\n  sendEmail: CloudflareSendEmailFn;\n}\n\n/** Error thrown when the Cloudflare Email binding rejects a send. */\nexport class CloudflareEmailError extends SentlyError {\n  /** Creates a Cloudflare Email binding error. */\n  constructor(message: string, cause?: unknown) {\n    super(message, \"PROVIDER_ERROR\", { provider: \"cloudflare-email\", cause });\n    this.name = \"CloudflareEmailError\";\n  }\n}\n\n/**\n * Cloudflare Workers Email binding transport.\n */\nexport class CloudflareEmailTransport implements Transport {\n  readonly provider = \"cloudflare-email\";\n\n  private readonly sendEmail: CloudflareSendEmailFn;\n\n  /** Creates a transport backed by the Workers `send_email` binding. */\n  constructor(config: CloudflareEmailConfig) {\n    this.sendEmail = config.sendEmail;\n  }\n\n  /** Sends an email via the Workers `send_email` binding. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const from = parseAddresses(options.from)[0];\n    const toEmails = extractEmails(options.to);\n    const primaryTo = toEmails[0];\n\n    if (!from || !primaryTo) {\n      throw new CloudflareEmailError(\"Cloudflare Email requires from and to addresses\");\n    }\n\n    const content: CloudflareEmailMessage[\"content\"] = [];\n    if (options.text !== undefined) {\n      content.push({ type: \"text/plain\", value: options.text });\n    }\n    if (options.html !== undefined) {\n      content.push({ type: \"text/html\", value: options.html });\n    }\n    if (content.length === 0) {\n      content.push({ type: \"text/plain\", value: \"\" });\n    }\n\n    const attachments = await resolveAttachments(options.attachments);\n    const message: CloudflareEmailMessage = {\n      from: from.address,\n      to: primaryTo,\n      subject: options.subject,\n      content,\n      ...(options.replyTo ? { reply_to: extractEmails(options.replyTo)[0] } : {}),\n      ...(options.cc ? { cc: extractEmails(options.cc) } : {}),\n      ...(options.bcc ? { bcc: extractEmails(options.bcc) } : {}),\n      ...(options.headers ? { headers: options.headers } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachments: attachments.map((att) => ({\n              disposition: att.inline ? (\"inline\" as const) : (\"attachment\" as const),\n              filename: att.filename,\n              type: att.contentType ?? \"application/octet-stream\",\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : String(att.content ?? \"\"),\n            })),\n          }\n        : {}),\n    };\n\n    try {\n      await this.sendEmail(message);\n    } catch (err) {\n      throw new CloudflareEmailError(\n        err instanceof Error ? err.message : \"Cloudflare Email send failed\",\n        err,\n      );\n    }\n\n    return {\n      messageId: options.messageId ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: \"sent via Cloudflare Email binding\",\n      envelope: {\n        from: from.address,\n        to: toEmails,\n      },\n    };\n  }\n\n  /**\n   * Confirms the binding is configured — no network validation is available.\n   */\n  async verify(): Promise<VerifyResult> {\n    return {\n      ok: true,\n      provider: \"cloudflare-email\",\n      message: \"send_email binding configured (not validated at runtime)\",\n    };\n  }\n}\n"
+  ],
+  "mappings": "6NAgEO,CAAM,KAA6B,JAAY,JAEpD,WAAW,CAAC,EAAiB,EAAiB,CAC5C,MAAM,EAAS,iBAAkB,CAAE,SAAU,mBAAoB,OAAM,CAAC,EACxE,KAAK,KAAO,uBAEhB,CAKO,MAAM,CAA8C,CAChD,SAAW,mBAEH,UAGjB,WAAW,CAAC,EAA+B,CACzC,KAAK,UAAY,EAAO,eAIpB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAO,EAAe,EAAQ,IAAI,EAAE,GACpC,EAAW,EAAc,EAAQ,EAAE,EACnC,EAAY,EAAS,GAE3B,GAAI,CAAC,GAAQ,CAAC,EACZ,MAAM,IAAI,EAAqB,iDAAiD,EAGlF,IAAM,EAA6C,CAAC,EACpD,GAAI,EAAQ,OAAS,OACnB,EAAQ,KAAK,CAAE,KAAM,aAAc,MAAO,EAAQ,IAAK,CAAC,EAE1D,GAAI,EAAQ,OAAS,OACnB,EAAQ,KAAK,CAAE,KAAM,YAAa,MAAO,EAAQ,IAAK,CAAC,EAEzD,GAAI,EAAQ,SAAW,EACrB,EAAQ,KAAK,CAAE,KAAM,aAAc,MAAO,EAAG,CAAC,EAGhD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAkC,CACtC,KAAM,EAAK,QACX,GAAI,EACJ,QAAS,EAAQ,QACjB,aACI,EAAQ,QAAU,CAAE,SAAU,EAAc,EAAQ,OAAO,EAAE,EAAG,EAAI,CAAC,KACrE,EAAQ,GAAK,CAAE,GAAI,EAAc,EAAQ,EAAE,CAAE,EAAI,CAAC,KAClD,EAAQ,IAAM,CAAE,IAAK,EAAc,EAAQ,GAAG,CAAE,EAAI,CAAC,KACrD,EAAQ,QAAU,CAAE,QAAS,EAAQ,OAAQ,EAAI,CAAC,KAClD,EAAY,OAAS,EACrB,CACE,YAAa,EAAY,IAAI,CAAC,KAAS,CACrC,YAAa,EAAI,OAAU,SAAsB,aACjD,SAAU,EAAI,SACd,KAAM,EAAI,aAAe,2BACzB,QACE,EAAI,mBAAmB,WACnB,EAAa,EAAI,OAAO,EAAE,QAAQ,QAAS,EAAE,EAC7C,OAAO,EAAI,SAAW,EAAE,CAChC,EAAE,CACJ,EACA,CAAC,CACP,EAEA,GAAI,CACF,MAAM,KAAK,UAAU,CAAO,EAC5B,MAAO,EAAK,CACZ,MAAM,IAAI,EACR,aAAe,MAAQ,EAAI,QAAU,+BACrC,CACF,EAGF,MAAO,CACL,UAAW,EAAQ,WAAa,GAChC,SAAU,EACV,SAAU,CAAC,EACX,SAAU,oCACV,SAAU,CACR,KAAM,EAAK,QACX,GAAI,CACN,CACF,OAMI,OAAM,EAA0B,CACpC,MAAO,CACL,GAAI,GACJ,SAAU,mBACV,QAAS,0DACX,EAEJ",
+  "debugId": "12AACAC7726534CE64756E2164756E21",
+  "names": []
+}

package/dist/transports/fallback.d.ts

@@ -0,0 +1,100 @@
+import { getProviderLabel } from "../core/provider-label.js";
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** One failed provider attempt collected during failover. */
+export interface FallbackAttempt {
+    /** Provider label (e.g. `"resend"`, `"ses"`). */
+    provider: string;
+    /** Error thrown by that transport. */
+    error: unknown;
+}
+/** Per-provider result from {@link FallbackTransport.verifyAll}. */
+export interface FallbackProviderVerifyResult {
+    /** Provider label. */
+    provider: string;
+    /** Whether this provider verified successfully. */
+    ok: boolean;
+    /** Human-readable status from the provider verify call. */
+    message?: string;
+}
+/** Result of verifying every transport in a fallback chain. */
+export interface FallbackVerifyAllResult {
+    /** True when at least one provider in the chain verified successfully. */
+    ok: boolean;
+    /** Per-provider verify results in chain order. */
+    providers: FallbackProviderVerifyResult[];
+}
+/** Options for {@link FallbackTransport} failover behavior. */
+export interface FallbackOptions {
+    /**
+     * Decide whether a given error should trigger failover to the next
+     * transport. Default: fail over on everything EXCEPT permanent client
+     * errors (HTTP 400/401/403, SMTP permanent 5xx auth failures), since
+     * those will fail identically on every provider.
+     */
+    shouldFallback?: (error: unknown) => boolean;
+    /** Optional callback fired before advancing to the next transport. */
+    onFallback?: (failedIndex: number, error: unknown) => void;
+    /**
+     * After a failed send, skip this provider until the cooldown expires (ms).
+     * Prevents hammering a failing provider during an outage.
+     */
+    cooldownMs?: number;
+    /** Injectable clock for cooldown and testing. Default: `Date.now`. */
+    now?: () => number;
+    /**
+     * Shared cooldown state across fallback instances (e.g. {@link WeightedFallbackTransport}).
+     * @internal
+     */
+    cooldownState?: Map<string, number>;
+}
+/**
+ * Thrown when every transport in the chain fails.
+ * {@link FallbackAttempt} entries record which provider failed and why.
+ */
+export declare class FallbackError extends Error {
+    /** All failed attempts in order — which provider failed and why. */
+    readonly attempts: FallbackAttempt[];
+    /** Creates an error summarizing every failed transport attempt. */
+    constructor(attempts: FallbackAttempt[]);
+}
+/** @deprecated Use {@link getProviderLabel} from `sently/core` patterns. */
+export declare const inferProviderLabel: typeof getProviderLabel;
+type MailerOnFallback = (failedProvider: string, nextProvider: string, error: unknown) => void | Promise<void>;
+/**
+ * Decorator transport that fails over through an ordered list of transports.
+ */
+export declare class FallbackTransport implements Transport {
+    private readonly transports;
+    readonly provider = "fallback";
+    private readonly shouldFallback;
+    private readonly onFallback?;
+    private readonly cooldownMs;
+    private readonly now;
+    private readonly unhealthyUntil;
+    private mailerOnFallback;
+    /**
+     * Creates a failover transport over an ordered list of backends.
+     * @throws {Error} When the transports array is empty.
+     */
+    constructor(transports: Transport[], options?: FallbackOptions);
+    /**
+     * Register a per-send onFallback callback from mailer lifecycle hooks.
+     * @internal Used by {@link MailerImpl}; cleared after each send.
+     */
+    setMailerOnFallback(callback: MailerOnFallback | undefined): void;
+    private isCoolingDown;
+    private markUnhealthy;
+    /** Sends through transports in order until one succeeds. */
+    send(message: MailOptions): Promise<SendResult>;
+    private findNextTryIndex;
+    /**
+     * Returns the result of the first transport whose verify() returns `ok: true`.
+     * Use {@link verifyAll} for full-chain visibility.
+     */
+    verify(): Promise<VerifyResult>;
+    /** Verifies every transport in the chain and returns per-provider results. */
+    verifyAll(): Promise<FallbackVerifyAllResult>;
+    /** Calls close() on every transport; one failure does not block the others. */
+    close(): Promise<void>;
+}
+export {};

package/dist/transports/fallback.js

@@ -0,0 +1,3 @@
+import{i as a,j as b,k as c}from"../chunk-0gqy32pe.js";import"../chunk-gp4fwrs8.js";import"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";export{b as inferProviderLabel,c as FallbackTransport,a as FallbackError};
+
+//# debugId=2A42FFD9B78F28F364756E2164756E21

package/dist/transports/fallback.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "2A42FFD9B78F28F364756E2164756E21",
+  "names": []
+}

package/dist/transports/loops.d.ts

@@ -0,0 +1,32 @@
+import { SentlyError } from "../core/errors.js";
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Loops HTTP API configuration. */
+export interface LoopsConfig {
+    /** Loops API key for Bearer authentication. */
+    apiKey: string;
+    /** Default transactional template ID when not set per message via header. */
+    defaultTransactionalId?: string;
+}
+/** Error thrown when the Loops API returns a non-success response. */
+export declare class LoopsError extends SentlyError {
+    readonly statusCode: number;
+    readonly apiError: unknown;
+    /** Creates a Loops API error with status code. */
+    constructor(message: string, statusCode: number, apiError: unknown);
+}
+/**
+ * Loops transactional HTTP API transport.
+ */
+export declare class LoopsTransport implements Transport {
+    readonly provider = "loops";
+    private readonly apiKey;
+    private readonly defaultTransactionalId?;
+    /** Creates a Loops transport with the given API key. */
+    constructor(config: LoopsConfig);
+    /** Sends a transactional email via the Loops HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /**
+     * Returns success without a network call — Loops has no simple verify endpoint.
+     */
+    verify(): Promise<VerifyResult>;
+}

package/dist/transports/loops.js

@@ -0,0 +1,3 @@
+import{S as K}from"../chunk-93vqxxj2.js";import"../chunk-ywq6s10g.js";import{ca as M,da as P}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class G extends M{statusCode;apiError;constructor(q,B,z){super(q,P(B),{statusCode:B,provider:"loops",cause:z});this.statusCode=B;this.apiError=z;this.name="LoopsError"}}var U="x-loops-transactional-id";class V{provider="loops";apiKey;defaultTransactionalId;constructor(q){if(this.apiKey=q.apiKey,q.defaultTransactionalId!==void 0)this.defaultTransactionalId=q.defaultTransactionalId}async send(q){let B=q.headers?.[U]??this.defaultTransactionalId;if(!B)throw new G("Loops requires a transactional template ID. Set options.headers['x-loops-transactional-id'] or LoopsConfig.defaultTransactionalId. Loops cannot send raw subject/html/text.",400,{code:"MISSING_TRANSACTIONAL_ID"});let z=K(q.to)[0];if(!z)throw new G("Loops requires at least one recipient in options.to",400,{code:"MISSING_RECIPIENT"});let Q={transactionalId:B,email:z,dataVariables:q.data??{}},J=await fetch("https://app.loops.so/api/v1/transactional",{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(Q)}),F=await J.json();if(!J.ok||F.success===!1)throw new G(F.message??"Loops API error",J.status,F);return{messageId:F.id??"",accepted:[z],rejected:[],response:F.id??"sent",envelope:{from:K(q.from)[0]??"",to:[z]}}}async verify(){return{ok:!0,provider:"loops",message:"key not validated (no verify endpoint)"}}}export{V as LoopsTransport,G as LoopsError};
+
+//# debugId=155A09B7C69A1BDB64756E2164756E21

package/dist/transports/loops.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/loops.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Loops transactional HTTP transport for sently.\n *\n * Loops is template-first. `subject`, `html`, and `text` are ignored — provide a\n * transactional template ID and data variables instead.\n *\n * Set the template ID per message via the `x-loops-transactional-id` header, or\n * configure a default with `defaultTransactionalId` on the transport constructor.\n * Data variables are read from `options.data`.\n *\n * @example\n * ```ts\n * import { LoopsTransport } from \"sently/transports/loops\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new LoopsTransport({ apiKey: process.env.LOOPS_API_KEY! }),\n * });\n *\n * await mailer.send({\n *   from: \"noreply@example.com\",\n *   to: \"user@example.com\",\n *   subject: \"ignored by Loops\",\n *   headers: { \"x-loops-transactional-id\": \"clxxxxxxxx\" },\n *   data: { firstName: \"Ada\" },\n * });\n * ```\n */\nimport { extractEmails } from \"../core/address.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\n\n/** Loops HTTP API configuration. */\nexport interface LoopsConfig {\n  /** Loops API key for Bearer authentication. */\n  apiKey: string;\n  /** Default transactional template ID when not set per message via header. */\n  defaultTransactionalId?: string;\n}\n\n/** Error thrown when the Loops API returns a non-success response. */\nexport class LoopsError extends SentlyError {\n  /** Creates a Loops API error with status code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"loops\",\n      cause: apiError,\n    });\n    this.name = \"LoopsError\";\n  }\n}\n\nconst TRANSACTIONAL_ID_HEADER = \"x-loops-transactional-id\";\n\n/**\n * Loops transactional HTTP API transport.\n */\nexport class LoopsTransport implements Transport {\n  readonly provider = \"loops\";\n\n  private readonly apiKey: string;\n  private readonly defaultTransactionalId?: string;\n\n  /** Creates a Loops transport with the given API key. */\n  constructor(config: LoopsConfig) {\n    this.apiKey = config.apiKey;\n    if (config.defaultTransactionalId !== undefined) {\n      this.defaultTransactionalId = config.defaultTransactionalId;\n    }\n  }\n\n  /** Sends a transactional email via the Loops HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const transactionalId =\n      options.headers?.[TRANSACTIONAL_ID_HEADER] ?? this.defaultTransactionalId;\n\n    if (!transactionalId) {\n      throw new LoopsError(\n        \"Loops requires a transactional template ID. Set options.headers['x-loops-transactional-id'] or LoopsConfig.defaultTransactionalId. Loops cannot send raw subject/html/text.\",\n        400,\n        { code: \"MISSING_TRANSACTIONAL_ID\" },\n      );\n    }\n\n    const recipient = extractEmails(options.to)[0];\n    if (!recipient) {\n      throw new LoopsError(\"Loops requires at least one recipient in options.to\", 400, {\n        code: \"MISSING_RECIPIENT\",\n      });\n    }\n\n    const body = {\n      transactionalId,\n      email: recipient,\n      dataVariables: options.data ?? {},\n    };\n\n    const response = await fetch(\"https://app.loops.so/api/v1/transactional\", {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      success?: boolean;\n      id?: string;\n      message?: string;\n    };\n\n    if (!response.ok || payload.success === false) {\n      throw new LoopsError(payload.message ?? \"Loops API error\", response.status, payload);\n    }\n\n    return {\n      messageId: payload.id ?? \"\",\n      accepted: [recipient],\n      rejected: [],\n      response: payload.id ?? \"sent\",\n      envelope: {\n        from: extractEmails(options.from)[0] ?? \"\",\n        to: [recipient],\n      },\n    };\n  }\n\n  /**\n   * Returns success without a network call — Loops has no simple verify endpoint.\n   */\n  async verify(): Promise<VerifyResult> {\n    return {\n      ok: true,\n      provider: \"loops\",\n      message: \"key not validated (no verify endpoint)\",\n    };\n  }\n}\n"
+  ],
+  "mappings": "oKA0CO,CAAM,KAAmB,JAAY,CAIxB,WACA,SAHlB,WAAW,CACT,EACgB,EACA,EAChB,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,QACV,MAAO,CACT,CAAC,EAPe,kBACA,gBAOhB,KAAK,KAAO,aAEhB,CAEA,IAAM,EAA0B,2BAKzB,MAAM,CAAoC,CACtC,SAAW,QAEH,OACA,uBAGjB,WAAW,CAAC,EAAqB,CAE/B,GADA,KAAK,OAAS,EAAO,OACjB,EAAO,yBAA2B,OACpC,KAAK,uBAAyB,EAAO,4BAKnC,KAAI,CAAC,EAA2C,CACpD,IAAM,EACJ,EAAQ,UAAU,IAA4B,KAAK,uBAErD,GAAI,CAAC,EACH,MAAM,IAAI,EACR,8KACA,IACA,CAAE,KAAM,0BAA2B,CACrC,EAGF,IAAM,EAAY,EAAc,EAAQ,EAAE,EAAE,GAC5C,GAAI,CAAC,EACH,MAAM,IAAI,EAAW,sDAAuD,IAAK,CAC/E,KAAM,mBACR,CAAC,EAGH,IAAM,EAAO,CACX,kBACA,MAAO,EACP,cAAe,EAAQ,MAAQ,CAAC,CAClC,EAEM,EAAW,MAAM,MAAM,4CAA6C,CACxE,OAAQ,OACR,QAAS,CACP,cAAe,UAAU,KAAK,SAC9B,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAMrC,GAAI,CAAC,EAAS,IAAM,EAAQ,UAAY,GACtC,MAAM,IAAI,EAAW,EAAQ,SAAW,kBAAmB,EAAS,OAAQ,CAAO,EAGrF,MAAO,CACL,UAAW,EAAQ,IAAM,GACzB,SAAU,CAAC,CAAS,EACpB,SAAU,CAAC,EACX,SAAU,EAAQ,IAAM,OACxB,SAAU,CACR,KAAM,EAAc,EAAQ,IAAI,EAAE,IAAM,GACxC,GAAI,CAAC,CAAS,CAChB,CACF,OAMI,OAAM,EAA0B,CACpC,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,wCACX,EAEJ",
+  "debugId": "155A09B7C69A1BDB64756E2164756E21",
+  "names": []
+}

package/dist/transports/mailersend.d.ts

@@ -0,0 +1,27 @@
+import { SentlyError } from "../core/errors.js";
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** MailerSend HTTP API configuration. */
+export interface MailerSendConfig {
+    /** MailerSend API token for Bearer authentication. */
+    apiToken: string;
+}
+/** Error thrown when the MailerSend API returns a non-success response. */
+export declare class MailerSendError extends SentlyError {
+    readonly statusCode: number;
+    readonly apiError: unknown;
+    /** Creates a MailerSend API error with status code. */
+    constructor(message: string, statusCode: number, apiError: unknown);
+}
+/**
+ * MailerSend HTTP API transport.
+ */
+export declare class MailerSendTransport implements Transport {
+    readonly provider = "mailersend";
+    private readonly apiToken;
+    /** Creates a MailerSend transport with the given API token. */
+    constructor(config: MailerSendConfig);
+    /** Sends an email via the MailerSend HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies the MailerSend API token by listing domains. */
+    verify(): Promise<VerifyResult>;
+}

package/dist/transports/mailersend.js

@@ -0,0 +1,3 @@
+import{I as U}from"../chunk-skqhj0rm.js";import{Q as G,S as N}from"../chunk-93vqxxj2.js";import{Y as L}from"../chunk-ywq6s10g.js";import{ca as Q,da as R}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class W extends Q{statusCode;apiError;constructor(q,z,D){super(q,R(z),{statusCode:z,provider:"mailersend",cause:D});this.statusCode=z;this.apiError=D;this.name="MailerSendError"}}function H(q){return G(q).map((z)=>({email:z.address,...z.name?{name:z.name}:{}}))}class Y{provider="mailersend";apiToken;constructor(q){this.apiToken=q.apiToken}async send(q){let z=await U(q.attachments),D=G(q.from)[0],X={from:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},to:H(q.to),subject:q.subject,...q.cc?{cc:H(q.cc)}:{},...q.bcc?{bcc:H(q.bcc)}:{},...q.replyTo?{reply_to:(()=>{let w=G(q.replyTo)[0];return w?{email:w.address,...w.name?{name:w.name}:{}}:void 0})()}:{},...q.text?{text:q.text}:{},...q.html?{html:q.html}:{},...z.length>0?{attachments:z.map((w)=>({filename:w.filename,content:w.content instanceof Uint8Array?L(w.content).replace(/\r\n/g,""):w.content,disposition:"attachment"}))}:{}},F=await fetch("https://api.mailersend.com/v1/email",{method:"POST",headers:{Authorization:`Bearer ${this.apiToken}`,"Content-Type":"application/json"},body:JSON.stringify(X)});if(!F.ok){let w=await F.json().catch(()=>({}));throw new W(w.message??"MailerSend API error",F.status,w)}let J=F.headers.get("x-message-id")??"",K=N(q.to);return{messageId:J,accepted:K,rejected:[],response:J||"accepted",envelope:{from:D?.address??"",to:K}}}async verify(){try{let q=await fetch("https://api.mailersend.com/v1/domains",{headers:{Authorization:`Bearer ${this.apiToken}`}});if(!q.ok)return{ok:!1,provider:"mailersend",message:(await q.json().catch(()=>({}))).message??`HTTP ${q.status}`};return{ok:!0,provider:"mailersend",message:"API token is valid"}}catch(q){return{ok:!1,provider:"mailersend",message:q instanceof Error?q.message:String(q)}}}}export{Y as MailerSendTransport,W as MailerSendError};
+
+//# debugId=01F773171442CE1F64756E2164756E21

package/dist/transports/mailersend.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/mailersend.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * MailerSend HTTP transport for sently.\n *\n * @example\n * ```ts\n * import { MailerSendTransport } from \"sently/transports/mailersend\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new MailerSendTransport({ apiToken: process.env.MAILERSEND_API_TOKEN! }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** MailerSend HTTP API configuration. */\nexport interface MailerSendConfig {\n  /** MailerSend API token for Bearer authentication. */\n  apiToken: string;\n}\n\n/** Error thrown when the MailerSend API returns a non-success response. */\nexport class MailerSendError extends SentlyError {\n  /** Creates a MailerSend API error with status code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"mailersend\",\n      cause: apiError,\n    });\n    this.name = \"MailerSendError\";\n  }\n}\n\nfunction toAddressObjects(input: MailOptions[\"to\"]): Array<{ email: string; name?: string }> {\n  return parseAddresses(input).map((addr) => ({\n    email: addr.address,\n    ...(addr.name ? { name: addr.name } : {}),\n  }));\n}\n\n/**\n * MailerSend HTTP API transport.\n */\nexport class MailerSendTransport implements Transport {\n  readonly provider = \"mailersend\";\n\n  private readonly apiToken: string;\n\n  /** Creates a MailerSend transport with the given API token. */\n  constructor(config: MailerSendConfig) {\n    this.apiToken = config.apiToken;\n  }\n\n  /** Sends an email via the MailerSend HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body: Record<string, unknown> = {\n      from: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      to: toAddressObjects(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: toAddressObjects(options.cc) } : {}),\n      ...(options.bcc ? { bcc: toAddressObjects(options.bcc) } : {}),\n      ...(options.replyTo\n        ? {\n            reply_to: (() => {\n              const reply = parseAddresses(options.replyTo as MailOptions[\"to\"])[0];\n              return reply\n                ? { email: reply.address, ...(reply.name ? { name: reply.name } : {}) }\n                : undefined;\n            })(),\n          }\n        : {}),\n      ...(options.text ? { text: options.text } : {}),\n      ...(options.html ? { html: options.html } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachments: attachments.map((att) => ({\n              filename: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n              disposition: \"attachment\",\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.mailersend.com/v1/email\", {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiToken}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const payload = (await response.json().catch(() => ({}))) as {\n        message?: string;\n        errors?: unknown;\n      };\n      throw new MailerSendError(\n        payload.message ?? \"MailerSend API error\",\n        response.status,\n        payload,\n      );\n    }\n\n    const messageId = response.headers.get(\"x-message-id\") ?? \"\";\n    const toEmails = extractEmails(options.to);\n\n    return {\n      messageId,\n      accepted: toEmails,\n      rejected: [],\n      response: messageId || \"accepted\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the MailerSend API token by listing domains. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.mailersend.com/v1/domains\", {\n        headers: {\n          Authorization: `Bearer ${this.apiToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const payload = (await response.json().catch(() => ({}))) as { message?: string };\n        return {\n          ok: false,\n          provider: \"mailersend\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"mailersend\", message: \"API token is valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"mailersend\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "qOA2BO,CAAM,KAAwB,JAAY,JAI7B,WACA,SAHlB,WAAW,CACT,EACgB,EACA,EAChB,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,aACV,MAAO,CACT,CAAC,EAPe,kBACA,gBAOhB,KAAK,KAAO,kBAEhB,CAEA,SAAS,CAAgB,CAAC,EAAmE,CAC3F,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC,KAAU,CAC1C,MAAO,EAAK,WACR,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CACzC,EAAE,EAMG,MAAM,CAAyC,CAC3C,SAAW,aAEH,SAGjB,WAAW,CAAC,EAA0B,CACpC,KAAK,SAAW,EAAO,cAInB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAO,EAAe,EAAQ,IAAI,EAAE,GAEpC,EAAgC,CACpC,KAAM,EACF,CAAE,MAAO,EAAK,WAAa,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CAAG,EACjE,CAAE,MAAO,EAAG,EAChB,GAAI,EAAiB,EAAQ,EAAE,EAC/B,QAAS,EAAQ,WACb,EAAQ,GAAK,CAAE,GAAI,EAAiB,EAAQ,EAAE,CAAE,EAAI,CAAC,KACrD,EAAQ,IAAM,CAAE,IAAK,EAAiB,EAAQ,GAAG,CAAE,EAAI,CAAC,KACxD,EAAQ,QACR,CACE,UAAW,IAAM,CACf,IAAM,EAAQ,EAAe,EAAQ,OAA4B,EAAE,GACnE,OAAO,EACH,CAAE,MAAO,EAAM,WAAa,EAAM,KAAO,CAAE,KAAM,EAAM,IAAK,EAAI,CAAC,CAAG,EACpE,SACH,CACL,EACA,CAAC,KACD,EAAQ,KAAO,CAAE,KAAM,EAAQ,IAAK,EAAI,CAAC,KACzC,EAAQ,KAAO,CAAE,KAAM,EAAQ,IAAK,EAAI,CAAC,KACzC,EAAY,OAAS,EACrB,CACE,YAAa,EAAY,IAAI,CAAC,KAAS,CACrC,SAAU,EAAI,SACd,QACE,EAAI,mBAAmB,WACnB,EAAa,EAAI,OAAO,EAAE,QAAQ,QAAS,EAAE,EAC7C,EAAI,QACV,YAAa,YACf,EAAE,CACJ,EACA,CAAC,CACP,EAEM,EAAW,MAAM,MAAM,sCAAuC,CAClE,OAAQ,OACR,QAAS,CACP,cAAe,UAAU,KAAK,WAC9B,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAED,GAAI,CAAC,EAAS,GAAI,CAChB,IAAM,EAAW,MAAM,EAAS,KAAK,EAAE,MAAM,KAAO,CAAC,EAAE,EAIvD,MAAM,IAAI,EACR,EAAQ,SAAW,uBACnB,EAAS,OACT,CACF,EAGF,IAAM,EAAY,EAAS,QAAQ,IAAI,cAAc,GAAK,GACpD,EAAW,EAAc,EAAQ,EAAE,EAEzC,MAAO,CACL,YACA,SAAU,EACV,SAAU,CAAC,EACX,SAAU,GAAa,WACvB,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,GAAI,CACN,CACF,OAII,OAAM,EAA0B,CACpC,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,wCAAyC,CACpE,QAAS,CACP,cAAe,UAAU,KAAK,UAChC,CACF,CAAC,EAED,GAAI,CAAC,EAAS,GAEZ,MAAO,CACL,GAAI,GACJ,SAAU,aACV,SAJe,MAAM,EAAS,KAAK,EAAE,MAAM,KAAO,CAAC,EAAE,GAIpC,SAAW,QAAQ,EAAS,QAC/C,EAGF,MAAO,CAAE,GAAI,GAAM,SAAU,aAAc,QAAS,oBAAqB,EACzE,MAAO,EAAK,CACZ,MAAO,CACL,GAAI,GACJ,SAAU,aACV,QAAS,aAAe,MAAQ,EAAI,QAAU,OAAO,CAAG,CAC1D,GAGN",
+  "debugId": "01F773171442CE1F64756E2164756E21",
+  "names": []
+}

package/dist/transports/mailgun.d.ts

@@ -11,6 +11,7 @@ export declare class MailgunError extends SentlyError {
  * Mailgun HTTP API transport (multipart/form-data).
  */
 export declare class MailgunTransport implements Transport {
+    readonly provider = "mailgun";
     /** Mailgun API key for basic authentication. */
     private readonly apiKey;
     /** Mailgun sending domain. */

package/dist/transports/mailgun.js

@@ -1,3 +1,3 @@
-import{s as W}from"../chunk-r7ee9tk7.js";import{A as J,B as Q,z as G}from"../chunk-gh5n759p.js";import{P as N}from"../chunk-d5rwm3br.js";import{T as R,U}from"../chunk-a1c87hn1.js";import"../chunk-keksa6fx.js";class X extends R{statusCode;apiError;constructor(q,z,F){super(q,U(z),{statusCode:z,provider:"mailgun",cause:F});this.statusCode=z;this.apiError=F;this.name="MailgunError"}}class ${apiKey;domain;baseUrl;constructor(q){this.apiKey=q.apiKey,this.domain=q.domain,this.baseUrl=q.region==="eu"?"https://api.eu.mailgun.net":"https://api.mailgun.net"}async send(q){let z=await W(q.attachments),F=G(q.from)[0],w=new FormData;if(w.append("from",F?J(F):""),w.append("to",G(q.to).map(J).join(", ")),q.cc)w.append("cc",G(q.cc).map(J).join(", "));if(q.bcc)w.append("bcc",G(q.bcc).map(J).join(", "));if(w.append("subject",q.subject),q.text)w.append("text",q.text);if(q.html)w.append("html",q.html);if(q.replyTo){let D=G(q.replyTo)[0];if(D)w.append("h:Reply-To",J(D))}for(let D of z){let Z=D.content instanceof Uint8Array?D.content:new TextEncoder().encode(String(D.content??"")),_=new Blob([new Uint8Array(Z)],{type:D.contentType??"application/octet-stream"});w.append("attachment",_,D.filename)}let Y=N(`api:${this.apiKey}`).replace(/\r\n/g,""),L=await fetch(`${this.baseUrl}/v3/${this.domain}/messages`,{method:"POST",headers:{Authorization:`Basic ${Y}`},body:w}),K=await L.json();if(!L.ok)throw new X(K.message??"Mailgun API error",L.status,K);let O=Q(q.to);return{messageId:K.id??"",accepted:O,rejected:[],response:K.message??"queued",envelope:{from:F?.address??"",to:O}}}async verify(){try{let q=N(`api:${this.apiKey}`).replace(/\r\n/g,""),z=await fetch(`${this.baseUrl}/v3/domains`,{headers:{Authorization:`Basic ${q}`}});if(!z.ok)return{ok:!1,provider:"mailgun",message:(await z.json().catch(()=>({}))).message??`HTTP ${z.status}`};return{ok:!0,provider:"mailgun",message:"API key is valid"}}catch(q){return{ok:!1,provider:"mailgun",message:q instanceof Error?q.message:String(q)}}}}export{$ as MailgunTransport,X as MailgunError};
+import{I as W}from"../chunk-skqhj0rm.js";import{Q as G,R as J,S as Q}from"../chunk-93vqxxj2.js";import{Y as N}from"../chunk-ywq6s10g.js";import{ca as R,da as U}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class X extends R{statusCode;apiError;constructor(q,z,F){super(q,U(z),{statusCode:z,provider:"mailgun",cause:F});this.statusCode=z;this.apiError=F;this.name="MailgunError"}}class ${provider="mailgun";apiKey;domain;baseUrl;constructor(q){this.apiKey=q.apiKey,this.domain=q.domain,this.baseUrl=q.region==="eu"?"https://api.eu.mailgun.net":"https://api.mailgun.net"}async send(q){let z=await W(q.attachments),F=G(q.from)[0],w=new FormData;if(w.append("from",F?J(F):""),w.append("to",G(q.to).map(J).join(", ")),q.cc)w.append("cc",G(q.cc).map(J).join(", "));if(q.bcc)w.append("bcc",G(q.bcc).map(J).join(", "));if(w.append("subject",q.subject),q.text)w.append("text",q.text);if(q.html)w.append("html",q.html);if(q.replyTo){let D=G(q.replyTo)[0];if(D)w.append("h:Reply-To",J(D))}for(let D of z){let Z=D.content instanceof Uint8Array?D.content:new TextEncoder().encode(String(D.content??"")),_=new Blob([new Uint8Array(Z)],{type:D.contentType??"application/octet-stream"});w.append("attachment",_,D.filename)}let Y=N(`api:${this.apiKey}`).replace(/\r\n/g,""),L=await fetch(`${this.baseUrl}/v3/${this.domain}/messages`,{method:"POST",headers:{Authorization:`Basic ${Y}`},body:w}),K=await L.json();if(!L.ok)throw new X(K.message??"Mailgun API error",L.status,K);let O=Q(q.to);return{messageId:K.id??"",accepted:O,rejected:[],response:K.message??"queued",envelope:{from:F?.address??"",to:O}}}async verify(){try{let q=N(`api:${this.apiKey}`).replace(/\r\n/g,""),z=await fetch(`${this.baseUrl}/v3/domains`,{headers:{Authorization:`Basic ${q}`}});if(!z.ok)return{ok:!1,provider:"mailgun",message:(await z.json().catch(()=>({}))).message??`HTTP ${z.status}`};return{ok:!0,provider:"mailgun",message:"API key is valid"}}catch(q){return{ok:!1,provider:"mailgun",message:q instanceof Error?q.message:String(q)}}}}export{$ as MailgunTransport,X as MailgunError};
 
-//# debugId=5E0CE52DDAABE05064756E2164756E21
+//# debugId=3693D707D234EDC064756E2164756E21

package/dist/transports/mailgun.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/transports/mailgun.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Mailgun HTTP transport for sently.\n * Uses the Mailgun Messages API v3 with multipart/form-data.\n *\n * @example\n * ```ts\n * import { MailgunTransport } from \"sently/transports/mailgun\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new MailgunTransport({\n *     apiKey: \"key-...\",\n *     domain: \"mg.example.com\",\n *   }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type {\n  MailgunConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Mailgun API returns a non-success response. */\nexport class MailgunError extends SentlyError {\n  /** Creates a Mailgun API error with status code and response payload. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"mailgun\",\n      cause: apiError,\n    });\n    this.name = \"MailgunError\";\n  }\n}\n\n/**\n * Mailgun HTTP API transport (multipart/form-data).\n */\nexport class MailgunTransport implements Transport {\n  /** Mailgun API key for basic authentication. */\n  private readonly apiKey: string;\n  /** Mailgun sending domain. */\n  private readonly domain: string;\n  /** Mailgun API base URL (US or EU region). */\n  private readonly baseUrl: string;\n\n  /** Creates a Mailgun transport with the given API key and domain. */\n  constructor(config: MailgunConfig) {\n    this.apiKey = config.apiKey;\n    this.domain = config.domain;\n    this.baseUrl =\n      config.region === \"eu\" ? \"https://api.eu.mailgun.net\" : \"https://api.mailgun.net\";\n  }\n\n  /** Sends an email via the Mailgun Messages API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n    const form = new FormData();\n\n    form.append(\"from\", from ? toMIMEHeader(from) : \"\");\n    form.append(\"to\", parseAddresses(options.to).map(toMIMEHeader).join(\", \"));\n\n    if (options.cc) {\n      form.append(\"cc\", parseAddresses(options.cc).map(toMIMEHeader).join(\", \"));\n    }\n    if (options.bcc) {\n      form.append(\"bcc\", parseAddresses(options.bcc).map(toMIMEHeader).join(\", \"));\n    }\n\n    form.append(\"subject\", options.subject);\n\n    if (options.text) {\n      form.append(\"text\", options.text);\n    }\n    if (options.html) {\n      form.append(\"html\", options.html);\n    }\n    if (options.replyTo) {\n      const replyTo = parseAddresses(options.replyTo)[0];\n      if (replyTo) {\n        form.append(\"h:Reply-To\", toMIMEHeader(replyTo));\n      }\n    }\n\n    for (const attachment of attachments) {\n      const content =\n        attachment.content instanceof Uint8Array\n          ? attachment.content\n          : new TextEncoder().encode(String(attachment.content ?? \"\"));\n      const blob = new Blob([new Uint8Array(content)], {\n        type: attachment.contentType ?? \"application/octet-stream\",\n      });\n      form.append(\"attachment\", blob, attachment.filename);\n    }\n\n    const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n    const response = await fetch(`${this.baseUrl}/v3/${this.domain}/messages`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n      body: form,\n    });\n\n    const payload = (await response.json()) as { id?: string; message?: string };\n\n    if (!response.ok) {\n      throw new MailgunError(payload.message ?? \"Mailgun API error\", response.status, payload);\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.id ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.message ?? \"queued\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Mailgun API key by listing domains. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n      const response = await fetch(`${this.baseUrl}/v3/domains`, {\n        headers: {\n          Authorization: `Basic ${auth}`,\n        },\n      });\n\n      if (!response.ok) {\n        const payload = (await response.json().catch(() => ({}))) as { message?: string };\n        return {\n          ok: false,\n          provider: \"mailgun\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"mailgun\", message: \"API key is valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"mailgun\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+    "/**\n * @module\n * Mailgun HTTP transport for sently.\n * Uses the Mailgun Messages API v3 with multipart/form-data.\n *\n * @example\n * ```ts\n * import { MailgunTransport } from \"sently/transports/mailgun\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new MailgunTransport({\n *     apiKey: \"key-...\",\n *     domain: \"mg.example.com\",\n *   }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type {\n  MailgunConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Mailgun API returns a non-success response. */\nexport class MailgunError extends SentlyError {\n  /** Creates a Mailgun API error with status code and response payload. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"mailgun\",\n      cause: apiError,\n    });\n    this.name = \"MailgunError\";\n  }\n}\n\n/**\n * Mailgun HTTP API transport (multipart/form-data).\n */\nexport class MailgunTransport implements Transport {\n  readonly provider = \"mailgun\";\n\n  /** Mailgun API key for basic authentication. */\n  private readonly apiKey: string;\n  /** Mailgun sending domain. */\n  private readonly domain: string;\n  /** Mailgun API base URL (US or EU region). */\n  private readonly baseUrl: string;\n\n  /** Creates a Mailgun transport with the given API key and domain. */\n  constructor(config: MailgunConfig) {\n    this.apiKey = config.apiKey;\n    this.domain = config.domain;\n    this.baseUrl =\n      config.region === \"eu\" ? \"https://api.eu.mailgun.net\" : \"https://api.mailgun.net\";\n  }\n\n  /** Sends an email via the Mailgun Messages API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n    const form = new FormData();\n\n    form.append(\"from\", from ? toMIMEHeader(from) : \"\");\n    form.append(\"to\", parseAddresses(options.to).map(toMIMEHeader).join(\", \"));\n\n    if (options.cc) {\n      form.append(\"cc\", parseAddresses(options.cc).map(toMIMEHeader).join(\", \"));\n    }\n    if (options.bcc) {\n      form.append(\"bcc\", parseAddresses(options.bcc).map(toMIMEHeader).join(\", \"));\n    }\n\n    form.append(\"subject\", options.subject);\n\n    if (options.text) {\n      form.append(\"text\", options.text);\n    }\n    if (options.html) {\n      form.append(\"html\", options.html);\n    }\n    if (options.replyTo) {\n      const replyTo = parseAddresses(options.replyTo)[0];\n      if (replyTo) {\n        form.append(\"h:Reply-To\", toMIMEHeader(replyTo));\n      }\n    }\n\n    for (const attachment of attachments) {\n      const content =\n        attachment.content instanceof Uint8Array\n          ? attachment.content\n          : new TextEncoder().encode(String(attachment.content ?? \"\"));\n      const blob = new Blob([new Uint8Array(content)], {\n        type: attachment.contentType ?? \"application/octet-stream\",\n      });\n      form.append(\"attachment\", blob, attachment.filename);\n    }\n\n    const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n    const response = await fetch(`${this.baseUrl}/v3/${this.domain}/messages`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n      body: form,\n    });\n\n    const payload = (await response.json()) as { id?: string; message?: string };\n\n    if (!response.ok) {\n      throw new MailgunError(payload.message ?? \"Mailgun API error\", response.status, payload);\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.id ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.message ?? \"queued\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Mailgun API key by listing domains. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n      const response = await fetch(`${this.baseUrl}/v3/domains`, {\n        headers: {\n          Authorization: `Basic ${auth}`,\n        },\n      });\n\n      if (!response.ok) {\n        const payload = (await response.json().catch(() => ({}))) as { message?: string };\n        return {\n          ok: false,\n          provider: \"mailgun\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"mailgun\", message: \"API key is valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"mailgun\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "5E0CE52DDAABE05064756E2164756E21",
+  "mappings": "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",
+  "debugId": "3693D707D234EDC064756E2164756E21",
   "names": []
 }

package/dist/transports/mailtrap.d.ts

@@ -0,0 +1,36 @@
+import { SentlyError } from "../core/errors.js";
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Mailtrap HTTP API configuration. */
+export interface MailtrapConfig {
+    /** Mailtrap API token for Bearer authentication. */
+    apiToken: string;
+    /** When true, use the sandbox send endpoint (requires `inboxId`). */
+    sandbox?: boolean;
+    /** Sandbox inbox ID — required when `sandbox` is true. */
+    inboxId?: string;
+}
+/** Error thrown when the Mailtrap API returns a non-success response. */
+export declare class MailtrapError extends SentlyError {
+    readonly statusCode: number;
+    readonly apiError: unknown;
+    /** Creates a Mailtrap API error with status code. */
+    constructor(message: string, statusCode: number, apiError: unknown);
+}
+/**
+ * Mailtrap HTTP API transport.
+ */
+export declare class MailtrapTransport implements Transport {
+    readonly provider = "mailtrap";
+    private readonly apiToken;
+    private readonly sandbox;
+    private readonly inboxId?;
+    /** Creates a Mailtrap transport with the given API token. */
+    constructor(config: MailtrapConfig);
+    private sendUrl;
+    /** Sends an email via the Mailtrap HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /**
+     * Returns success without a network call — Mailtrap has no simple verify endpoint.
+     */
+    verify(): Promise<VerifyResult>;
+}

package/dist/transports/mailtrap.js

@@ -0,0 +1,3 @@
+import{I as X}from"../chunk-skqhj0rm.js";import{Q as L,S as U}from"../chunk-93vqxxj2.js";import{Y as Q}from"../chunk-ywq6s10g.js";import{ca as V,da as W}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class K extends V{statusCode;apiError;constructor(q,z,D){super(q,W(z),{statusCode:z,provider:"mailtrap",cause:D});this.statusCode=z;this.apiError=D;this.name="MailtrapError"}}function J(q){return L(q).map((z)=>({email:z.address,...z.name?{name:z.name}:{}}))}class Z{provider="mailtrap";apiToken;sandbox;inboxId;constructor(q){if(this.apiToken=q.apiToken,this.sandbox=q.sandbox??!1,q.inboxId!==void 0)this.inboxId=q.inboxId}sendUrl(){if(this.sandbox){if(!this.inboxId)throw new K("Mailtrap sandbox mode requires inboxId",400,{code:"INVALID_CONFIG"});return`https://sandbox.api.mailtrap.io/api/send/${this.inboxId}`}return"https://send.api.mailtrap.io/api/send"}async send(q){let z=await X(q.attachments),D=L(q.from)[0],Y={from:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},to:J(q.to),subject:q.subject,...q.cc?{cc:J(q.cc)}:{},...q.bcc?{bcc:J(q.bcc)}:{},...q.text?{text:q.text}:{},...q.html?{html:q.html}:{},...z.length>0?{attachments:z.map((F)=>({filename:F.filename,content:F.content instanceof Uint8Array?Q(F.content).replace(/\r\n/g,""):F.content,type:F.contentType??"application/octet-stream"}))}:{}},H=await fetch(this.sendUrl(),{method:"POST",headers:{Authorization:`Bearer ${this.apiToken}`,"Content-Type":"application/json"},body:JSON.stringify(Y)}),G=await H.json();if(!H.ok||G.success!==!0)throw new K(G.message??"Mailtrap API error",H.status,G);let N=G.message_ids??[],P=U(q.to);return{messageId:N.join(","),accepted:P,rejected:[],response:N.join(",")||"sent",envelope:{from:D?.address??"",to:P}}}async verify(){return{ok:!0,provider:"mailtrap",message:"key not validated (no verify endpoint)"}}}export{Z as MailtrapTransport,K as MailtrapError};
+
+//# debugId=332E52E7FE5672B864756E2164756E21

package/dist/transports/mailtrap.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/mailtrap.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Mailtrap HTTP transport for sently.\n *\n * @example\n * ```ts\n * import { MailtrapTransport } from \"sently/transports/mailtrap\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new MailtrapTransport({ apiToken: process.env.MAILTRAP_API_TOKEN! }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Mailtrap HTTP API configuration. */\nexport interface MailtrapConfig {\n  /** Mailtrap API token for Bearer authentication. */\n  apiToken: string;\n  /** When true, use the sandbox send endpoint (requires `inboxId`). */\n  sandbox?: boolean;\n  /** Sandbox inbox ID — required when `sandbox` is true. */\n  inboxId?: string;\n}\n\n/** Error thrown when the Mailtrap API returns a non-success response. */\nexport class MailtrapError extends SentlyError {\n  /** Creates a Mailtrap API error with status code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message, httpStatusToSentlyCode(statusCode), {\n      statusCode,\n      provider: \"mailtrap\",\n      cause: apiError,\n    });\n    this.name = \"MailtrapError\";\n  }\n}\n\nfunction toAddressObjects(input: MailOptions[\"to\"]): Array<{ email: string; name?: string }> {\n  return parseAddresses(input).map((addr) => ({\n    email: addr.address,\n    ...(addr.name ? { name: addr.name } : {}),\n  }));\n}\n\n/**\n * Mailtrap HTTP API transport.\n */\nexport class MailtrapTransport implements Transport {\n  readonly provider = \"mailtrap\";\n\n  private readonly apiToken: string;\n  private readonly sandbox: boolean;\n  private readonly inboxId?: string;\n\n  /** Creates a Mailtrap transport with the given API token. */\n  constructor(config: MailtrapConfig) {\n    this.apiToken = config.apiToken;\n    this.sandbox = config.sandbox ?? false;\n    if (config.inboxId !== undefined) {\n      this.inboxId = config.inboxId;\n    }\n  }\n\n  private sendUrl(): string {\n    if (this.sandbox) {\n      if (!this.inboxId) {\n        throw new MailtrapError(\"Mailtrap sandbox mode requires inboxId\", 400, {\n          code: \"INVALID_CONFIG\",\n        });\n      }\n      return `https://sandbox.api.mailtrap.io/api/send/${this.inboxId}`;\n    }\n    return \"https://send.api.mailtrap.io/api/send\";\n  }\n\n  /** Sends an email via the Mailtrap HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body: Record<string, unknown> = {\n      from: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      to: toAddressObjects(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: toAddressObjects(options.cc) } : {}),\n      ...(options.bcc ? { bcc: toAddressObjects(options.bcc) } : {}),\n      ...(options.text ? { text: options.text } : {}),\n      ...(options.html ? { html: options.html } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachments: attachments.map((att) => ({\n              filename: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n              type: att.contentType ?? \"application/octet-stream\",\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(this.sendUrl(), {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiToken}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      success?: boolean;\n      message_ids?: string[];\n      message?: string;\n    };\n\n    if (!response.ok || payload.success !== true) {\n      throw new MailtrapError(payload.message ?? \"Mailtrap API error\", response.status, payload);\n    }\n\n    const messageIds = payload.message_ids ?? [];\n    const toEmails = extractEmails(options.to);\n\n    return {\n      messageId: messageIds.join(\",\"),\n      accepted: toEmails,\n      rejected: [],\n      response: messageIds.join(\",\") || \"sent\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /**\n   * Returns success without a network call — Mailtrap has no simple verify endpoint.\n   */\n  async verify(): Promise<VerifyResult> {\n    return {\n      ok: true,\n      provider: \"mailtrap\",\n      message: \"key not validated (no verify endpoint)\",\n    };\n  }\n}\n"
+  ],
+  "mappings": "qOA+BO,CAAM,KAAsB,JAAY,JAI3B,WACA,SAHlB,WAAW,CACT,EACgB,EACA,EAChB,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,WACV,MAAO,CACT,CAAC,EAPe,kBACA,gBAOhB,KAAK,KAAO,gBAEhB,CAEA,SAAS,CAAgB,CAAC,EAAmE,CAC3F,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC,KAAU,CAC1C,MAAO,EAAK,WACR,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CACzC,EAAE,EAMG,MAAM,CAAuC,CACzC,SAAW,WAEH,SACA,QACA,QAGjB,WAAW,CAAC,EAAwB,CAGlC,GAFA,KAAK,SAAW,EAAO,SACvB,KAAK,QAAU,EAAO,SAAW,GAC7B,EAAO,UAAY,OACrB,KAAK,QAAU,EAAO,QAIlB,OAAO,EAAW,CACxB,GAAI,KAAK,QAAS,CAChB,GAAI,CAAC,KAAK,QACR,MAAM,IAAI,EAAc,yCAA0C,IAAK,CACrE,KAAM,gBACR,CAAC,EAEH,MAAO,4CAA4C,KAAK,UAE1D,MAAO,6CAIH,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAO,EAAe,EAAQ,IAAI,EAAE,GAEpC,EAAgC,CACpC,KAAM,EACF,CAAE,MAAO,EAAK,WAAa,EAAK,KAAO,CAAE,KAAM,EAAK,IAAK,EAAI,CAAC,CAAG,EACjE,CAAE,MAAO,EAAG,EAChB,GAAI,EAAiB,EAAQ,EAAE,EAC/B,QAAS,EAAQ,WACb,EAAQ,GAAK,CAAE,GAAI,EAAiB,EAAQ,EAAE,CAAE,EAAI,CAAC,KACrD,EAAQ,IAAM,CAAE,IAAK,EAAiB,EAAQ,GAAG,CAAE,EAAI,CAAC,KACxD,EAAQ,KAAO,CAAE,KAAM,EAAQ,IAAK,EAAI,CAAC,KACzC,EAAQ,KAAO,CAAE,KAAM,EAAQ,IAAK,EAAI,CAAC,KACzC,EAAY,OAAS,EACrB,CACE,YAAa,EAAY,IAAI,CAAC,KAAS,CACrC,SAAU,EAAI,SACd,QACE,EAAI,mBAAmB,WACnB,EAAa,EAAI,OAAO,EAAE,QAAQ,QAAS,EAAE,EAC7C,EAAI,QACV,KAAM,EAAI,aAAe,0BAC3B,EAAE,CACJ,EACA,CAAC,CACP,EAEM,EAAW,MAAM,MAAM,KAAK,QAAQ,EAAG,CAC3C,OAAQ,OACR,QAAS,CACP,cAAe,UAAU,KAAK,WAC9B,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAMrC,GAAI,CAAC,EAAS,IAAM,EAAQ,UAAY,GACtC,MAAM,IAAI,EAAc,EAAQ,SAAW,qBAAsB,EAAS,OAAQ,CAAO,EAG3F,IAAM,EAAa,EAAQ,aAAe,CAAC,EACrC,EAAW,EAAc,EAAQ,EAAE,EAEzC,MAAO,CACL,UAAW,EAAW,KAAK,GAAG,EAC9B,SAAU,EACV,SAAU,CAAC,EACX,SAAU,EAAW,KAAK,GAAG,GAAK,OAClC,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,GAAI,CACN,CACF,OAMI,OAAM,EAA0B,CACpC,MAAO,CACL,GAAI,GACJ,SAAU,WACV,QAAS,wCACX,EAEJ",
+  "debugId": "332E52E7FE5672B864756E2164756E21",
+  "names": []
+}