sently 0.6.2 → 0.7.2

package/dist/chunk-a1c87hn1.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/core/errors.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Unified error hierarchy for sently transports and SMTP.\n */\n\n/** Stable machine-readable error codes shared across providers. */\nexport type SentlyErrorCode =\n  | \"SMTP_AUTH_FAILED\"\n  | \"RATE_LIMITED\"\n  | \"TIMEOUT\"\n  | \"CONNECTION_FAILED\"\n  | \"PROVIDER_ERROR\"\n  | \"BAD_REQUEST\";\n\n/** Options for constructing a {@link SentlyError}. */\nexport interface SentlyErrorOptions {\n  /** HTTP status code when the failure originated from an HTTP transport. */\n  statusCode?: number;\n  /** Original error or response payload. */\n  cause?: unknown;\n  /** Provider identifier (e.g. `\"smtp\"`, `\"resend\"`). */\n  provider?: string;\n}\n\n/**\n * Base error class for all sently transport and protocol failures.\n *\n * Subclasses may shadow {@link code} with provider-specific or numeric values\n * (e.g. SMTP response codes). Use {@link sentlyCode} for the stable machine-readable\n * code in those cases.\n */\nexport class SentlyError extends Error {\n  /**\n   * Stable machine-readable error code.\n   * Preserved even when a subclass shadows {@link code}.\n   */\n  readonly sentlyCode: SentlyErrorCode;\n\n  /** HTTP status code when applicable. */\n  readonly statusCode?: number;\n\n  /** Provider identifier when applicable. */\n  readonly provider?: string;\n\n  /**\n   * Error code — machine-readable string on {@link SentlyError}, or a legacy\n   * provider/SMTP-specific value on subclasses (numeric SMTP codes, Brevo/SES API codes).\n   */\n  code: string | number;\n\n  /** Creates a sently error with a machine-readable code and optional metadata. */\n  constructor(message: string, sentlyCode: SentlyErrorCode, options?: SentlyErrorOptions) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"SentlyError\";\n    this.sentlyCode = sentlyCode;\n    this.code = sentlyCode;\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.provider !== undefined) {\n      this.provider = options.provider;\n    }\n  }\n}\n\n/**\n * Map an HTTP status code to a stable sently error code.\n *\n * @param status - HTTP response status code\n * @returns Machine-readable error code\n */\nexport function httpStatusToSentlyCode(status: number): SentlyErrorCode {\n  if (status === 429) {\n    return \"RATE_LIMITED\";\n  }\n  if (status >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (status >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n\n/**\n * Map an SMTP response code and command to a stable sently error code.\n *\n * @param smtpCode - Three-digit SMTP response code (0 for local/parse errors)\n * @param command - SMTP command that failed\n * @returns Machine-readable error code\n */\nexport function smtpCodeToSentlyCode(smtpCode: number, command: string): SentlyErrorCode {\n  if (smtpCode === 535 || smtpCode === 534) {\n    return \"SMTP_AUTH_FAILED\";\n  }\n  if (smtpCode === 421 || smtpCode === 450 || smtpCode === 451) {\n    return \"TIMEOUT\";\n  }\n  if (smtpCode === 0) {\n    if (command === \"CONNECT\" || command === \"READ\" || command === \"MX\") {\n      return \"CONNECTION_FAILED\";\n    }\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n"
+    "/**\n * @module\n * Unified error hierarchy for sently transports and SMTP.\n */\n\n/** Stable machine-readable error codes shared across providers. */\nexport type SentlyErrorCode =\n  | \"INVALID_CONFIG\"\n  | \"SMTP_AUTH_FAILED\"\n  | \"RATE_LIMITED\"\n  | \"TIMEOUT\"\n  | \"CONNECTION_FAILED\"\n  | \"PROVIDER_ERROR\"\n  | \"BAD_REQUEST\";\n\n/** Options for constructing a {@link SentlyError}. */\nexport interface SentlyErrorOptions {\n  /** HTTP status code when the failure originated from an HTTP transport. */\n  statusCode?: number;\n  /** Original error or response payload. */\n  cause?: unknown;\n  /** Provider identifier (e.g. `\"smtp\"`, `\"resend\"`). */\n  provider?: string;\n}\n\n/**\n * Base error class for all sently transport and protocol failures.\n *\n * Subclasses may shadow {@link code} with provider-specific or numeric values\n * (e.g. SMTP response codes). Use {@link sentlyCode} for the stable machine-readable\n * code in those cases.\n */\nexport class SentlyError extends Error {\n  /**\n   * Stable machine-readable error code.\n   * Preserved even when a subclass shadows {@link code}.\n   */\n  readonly sentlyCode: SentlyErrorCode;\n\n  /** HTTP status code when applicable. */\n  readonly statusCode?: number;\n\n  /** Provider identifier when applicable. */\n  readonly provider?: string;\n\n  /**\n   * Error code — machine-readable string on {@link SentlyError}, or a legacy\n   * provider/SMTP-specific value on subclasses (numeric SMTP codes, Brevo/SES API codes).\n   */\n  code: string | number;\n\n  /** Creates a sently error with a machine-readable code and optional metadata. */\n  constructor(message: string, sentlyCode: SentlyErrorCode, options?: SentlyErrorOptions) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"SentlyError\";\n    this.sentlyCode = sentlyCode;\n    this.code = sentlyCode;\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.provider !== undefined) {\n      this.provider = options.provider;\n    }\n  }\n}\n\n/**\n * Map an HTTP status code to a stable sently error code.\n *\n * @param status - HTTP response status code\n * @returns Machine-readable error code\n */\nexport function httpStatusToSentlyCode(status: number): SentlyErrorCode {\n  if (status === 429) {\n    return \"RATE_LIMITED\";\n  }\n  if (status >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (status >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n\n/**\n * Map an SMTP response code and command to a stable sently error code.\n *\n * @param smtpCode - Three-digit SMTP response code (0 for local/parse errors)\n * @param command - SMTP command that failed\n * @returns Machine-readable error code\n */\nexport function smtpCodeToSentlyCode(smtpCode: number, command: string): SentlyErrorCode {\n  if (smtpCode === 535 || smtpCode === 534) {\n    return \"SMTP_AUTH_FAILED\";\n  }\n  if (smtpCode === 421 || smtpCode === 450 || smtpCode === 451) {\n    return \"TIMEOUT\";\n  }\n  if (smtpCode === 0) {\n    if (command === \"CONNECT\" || command === \"READ\" || command === \"MX\") {\n      return \"CONNECTION_FAILED\";\n    }\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n"
   ],
-  "mappings": "AA+BO,MAAM,UAAoB,KAAM,CAK5B,WAGA,WAGA,SAMT,KAGA,WAAW,CAAC,EAAiB,EAA6B,EAA8B,CACtF,MAAM,EAAS,GAAS,QAAU,OAAY,CAAE,MAAO,EAAQ,KAAM,EAAI,MAAS,EAIlF,GAHA,KAAK,KAAO,cACZ,KAAK,WAAa,EAClB,KAAK,KAAO,EACR,GAAS,aAAe,OAC1B,KAAK,WAAa,EAAQ,WAE5B,GAAI,GAAS,WAAa,OACxB,KAAK,SAAW,EAAQ,SAG9B,CAQO,SAAS,CAAsB,CAAC,EAAiC,CACtE,GAAI,IAAW,IACb,MAAO,eAET,GAAI,GAAU,IACZ,MAAO,iBAET,GAAI,GAAU,IACZ,MAAO,cAET,MAAO,iBAUF,SAAS,CAAoB,CAAC,EAAkB,EAAkC,CACvF,GAAI,IAAa,KAAO,IAAa,IACnC,MAAO,mBAET,GAAI,IAAa,KAAO,IAAa,KAAO,IAAa,IACvD,MAAO,UAET,GAAI,IAAa,EAAG,CAClB,GAAI,IAAY,WAAa,IAAY,QAAU,IAAY,KAC7D,MAAO,oBAET,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,cAET,MAAO",
+  "mappings": "AAgCO,MAAM,UAAoB,KAAM,CAK5B,WAGA,WAGA,SAMT,KAGA,WAAW,CAAC,EAAiB,EAA6B,EAA8B,CACtF,MAAM,EAAS,GAAS,QAAU,OAAY,CAAE,MAAO,EAAQ,KAAM,EAAI,MAAS,EAIlF,GAHA,KAAK,KAAO,cACZ,KAAK,WAAa,EAClB,KAAK,KAAO,EACR,GAAS,aAAe,OAC1B,KAAK,WAAa,EAAQ,WAE5B,GAAI,GAAS,WAAa,OACxB,KAAK,SAAW,EAAQ,SAG9B,CAQO,SAAS,CAAsB,CAAC,EAAiC,CACtE,GAAI,IAAW,IACb,MAAO,eAET,GAAI,GAAU,IACZ,MAAO,iBAET,GAAI,GAAU,IACZ,MAAO,cAET,MAAO,iBAUF,SAAS,CAAoB,CAAC,EAAkB,EAAkC,CACvF,GAAI,IAAa,KAAO,IAAa,IACnC,MAAO,mBAET,GAAI,IAAa,KAAO,IAAa,KAAO,IAAa,IACvD,MAAO,UAET,GAAI,IAAa,EAAG,CAClB,GAAI,IAAY,WAAa,IAAY,QAAU,IAAY,KAC7D,MAAO,oBAET,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,cAET,MAAO",
   "debugId": "09C74C7A3E8123A164756E2164756E21",
   "names": []
 }

package/dist/chunk-ka6t8g77.js

@@ -0,0 +1,4 @@
+import{x as O}from"./chunk-kebhy657.js";import{B as q}from"./chunk-gh5n759p.js";import{T as N}from"./chunk-a1c87hn1.js";async function T(j,w){if(!w||w.length===0)return j;let H=j;for(let W of w)H=await W(H);return H}function _(j){return typeof j.setMailerOnRetry==="function"}var f="SMTP config passed to transport-only createMailer. Use: import { createSMTPMailer } from 'sently' or import { createSMTPMailer } from 'sently/smtp'.";async function h(j){if(j.transport===void 0||"host"in j&&j.transport===void 0)throw new N(f,"INVALID_CONFIG");return new D(j.transport,j.plugins??[],j.hooks)}function S(j){return j.attachments!==void 0&&j.attachments.length>0}function b(j){let w=j.constructor.name;if(w==="Object")return"custom";if(w.endsWith("Transport"))return w.slice(0,-9).toLowerCase();return w.toLowerCase()||"unknown"}function F(j,w){return{...j.messageId!==void 0?{messageId:j.messageId}:{},to:q(j.to),subject:j.subject,provider:b(w)}}async function G(j,...w){if(j===void 0)return;try{await j(...w)}catch(H){if(!(typeof process<"u"&&process.env?.NODE_ENV==="production"))console.warn("[sently] Mailer hook threw; send continues:",H)}}class D{transport;plugins;hooks;constructor(j,w=[],H){this.transport=j;this.plugins=w;this.hooks=H}async send(j){let w=await T(j,this.plugins),H=F(w,this.transport);if(await G(this.hooks?.onSend,H),this.hooks?.onRetry!==void 0&&_(this.transport))this.transport.setMailerOnRetry((W,X)=>{G(this.hooks?.onRetry,H,W,X)});try{let W=await this.transport.send(w),X={...H,messageId:W.messageId};return await G(this.hooks?.onSuccess,X,W),W}catch(W){throw await G(this.hooks?.onError,H,W),W}finally{if(_(this.transport))this.transport.setMailerOnRetry(void 0)}}async processMessage(j){return T(j,this.plugins)}async sendBulk(j,w){if(j.length===0)return{total:0,sent:0,failed:0,results:[]};let H=Array(j.length),W=w?.stopOnError??!1,X=!1,M=async(Z,$,J,Q)=>{if(H[$]={status:"sent",result:J},Q!==void 0&&this.hooks!==void 0){let U=F(Q,this.transport);await G(this.hooks.onSend,U),await G(this.hooks.onSuccess,{...U,messageId:J.messageId},J)}w?.onSuccess?.(Z,$,J)},L=async(Z,$,J,Q)=>{if(H[$]={status:"failed",error:J},Q!==void 0&&this.hooks!==void 0){let U=F(Q,this.transport);await G(this.hooks.onSend,U),await G(this.hooks.onError,U,J)}if(w?.onError?.(Z,$,J),W)X=!0};if(this.transport.sendBatch){let Z=[],$=[];for(let[J,Q]of j.entries())if(S(Q))$.push({index:J,message:Q});else Z.push({index:J,message:Q});if(Z.length>0&&!X){let J=this.transport.batchMax??Z.length,Q=w?.rateDelta??2,U=Q>0?new O(Q,w?.rateLimit??1000,w?.now):null;for(let z=0;z<Z.length&&!X;z+=J){let V=Z.slice(z,z+J);if(U)await U.acquire();try{let Y=await Promise.all(V.map(({message:B})=>this.processMessage(B))),K=await this.transport.sendBatch(Y);for(let B=0;B<V.length;B++){let C=V[B],P=Y[B],A=K[B];if(A===void 0)await L(C.message,C.index,Error("Batch response missing result for message"),P);else if(A.batchError!==void 0)await L(C.message,C.index,A.batchError,P);else await M(C.message,C.index,A,P)}}catch(Y){let K=await Promise.all(V.map(({message:B})=>this.processMessage(B)));for(let B=0;B<V.length;B++){if(X)break;let C=V[B];await L(C.message,C.index,Y,K[B])}}}}if($.length>0&&!X){let J=w?.concurrency??1,Q=[...$],U=0;await new Promise((z)=>{let V=()=>{if(Q.length===0&&U===0||X)z()},Y=()=>{if(Q.length===0||X){V();return}let K=Q.shift();if(K===void 0){V();return}U++,this.send(K.message).then((B)=>{H[K.index]={status:"sent",result:B},w?.onSuccess?.(K.message,K.index,B)}).catch((B)=>{if(H[K.index]={status:"failed",error:B},w?.onError?.(K.message,K.index,B),W)X=!0}).finally(()=>{U--,Y(),V()})};for(let K=0;K<J;K++)Y()})}}else{let Z=w?.concurrency??1,$=[...j.entries()],J=0;await new Promise((Q)=>{let U=()=>{if($.length===0&&J===0||X)Q()},z=()=>{if($.length===0||X){U();return}let V=$.shift();if(V===void 0){U();return}let[Y,K]=V;J++,this.send(K).then((B)=>{H[Y]={status:"sent",result:B},w?.onSuccess?.(K,Y,B)}).catch((B)=>{if(H[Y]={status:"failed",error:B},w?.onError?.(K,Y,B),W)X=!0}).finally(()=>{J--,z(),U()})};for(let V=0;V<Z;V++)z()})}let I=0,R=0;for(let Z of H){if(Z===void 0)continue;if(Z.status==="sent")I++;else R++}return{total:j.length,sent:I,failed:R,results:H}}verify(){if(this.transport.verify)return this.transport.verify();return Promise.resolve({ok:!0,provider:"mailer"})}close(){if(this.transport.close)return this.transport.close();return Promise.resolve()}}
+export{h as v,D as w};
+
+//# debugId=C3B38A0E65479A2E64756E2164756E21

package/dist/chunk-ka6t8g77.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/plugin.ts", "../src/mailer.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Plugin pipeline for sently.\n * Plugins transform MailOptions before message construction.\n * They run sequentially — each receives the previous plugin's output.\n *\n * @example\n * ```ts\n * import { runPlugins } from \"sently/core/plugin\";\n * const result = await runPlugins(options, [pluginA, pluginB]);\n * ```\n */\nimport type { MailOptions, MailPlugin } from \"./types.js\";\n\n/**\n * Run a list of plugins sequentially over MailOptions.\n * If plugins is empty or undefined, returns options unchanged.\n * Each plugin may be sync or async.\n *\n * @param options - the original mail options\n * @param plugins - ordered list of plugins to apply\n * @returns transformed mail options after all plugins have run\n */\nexport async function runPlugins(\n  options: MailOptions,\n  plugins: MailPlugin[] | undefined,\n): Promise<MailOptions> {\n  if (!plugins || plugins.length === 0) {\n    return options;\n  }\n\n  let current = options;\n  for (const plugin of plugins) {\n    current = await plugin(current);\n  }\n  return current;\n}\n",
+    "/**\n * @module\n * Lightweight mailer factory for custom transports — no SMTP code in the bundle.\n *\n * Use this entry instead of `sently` when you pass a transport explicitly\n * (Resend, SendGrid, etc.) and want the smallest bundle size.\n *\n * @example\n * ```ts\n * import { createMailer } from \"sently/mailer\";\n * import { ResendTransport } from \"sently/transports/resend\";\n *\n * const mailer = await createMailer({\n *   transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),\n * });\n *\n * await mailer.send({\n *   from: \"onboarding@yourdomain.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>Sent via Resend</p>\",\n * });\n * ```\n */\nimport { extractEmails } from \"./core/address.js\";\nimport { SentlyError } from \"./core/errors.js\";\nimport { runPlugins } from \"./core/plugin.js\";\nimport { RateLimiter } from \"./core/rate-limiter.js\";\nimport type {\n  BulkSendOptions,\n  BulkSendResult,\n  Mailer,\n  MailerHookContext,\n  MailerHooks,\n  MailOptions,\n  MailPlugin,\n  SendResult,\n  Transport,\n  TransportMailerOptions,\n  VerifyResult,\n} from \"./core/types.js\";\n\nexport type { MailerHookContext, MailerHooks, TransportMailerOptions };\n\n/** Retry decorator wired by mailer hooks (duck-typed to avoid pulling retry into all bundles). */\ninterface RetryHookTransport extends Transport {\n  setMailerOnRetry(callback: ((attempt: number, error: unknown) => void) | undefined): void;\n}\n\nfunction isRetryHookTransport(transport: Transport): transport is RetryHookTransport {\n  return typeof (transport as RetryHookTransport).setMailerOnRetry === \"function\";\n}\n\nconst TRANSPORT_ONLY_SMTP_CONFIG_MESSAGE =\n  \"SMTP config passed to transport-only createMailer. Use: import { createSMTPMailer } from 'sently' or import { createSMTPMailer } from 'sently/smtp'.\";\n\n/**\n * Create a mailer that wraps a custom {@link Transport} (HTTP API, preview, retry, etc.).\n */\nexport async function createMailer(options: TransportMailerOptions): Promise<Mailer> {\n  if (options.transport === undefined || (\"host\" in options && options.transport === undefined)) {\n    throw new SentlyError(TRANSPORT_ONLY_SMTP_CONFIG_MESSAGE, \"INVALID_CONFIG\");\n  }\n\n  return new MailerImpl(options.transport, options.plugins ?? [], options.hooks);\n}\n\nfunction hasAttachments(message: MailOptions): boolean {\n  return message.attachments !== undefined && message.attachments.length > 0;\n}\n\n/** Infer a provider label from a transport instance for hook context. */\nfunction inferProvider(transport: Transport): string {\n  const name = transport.constructor.name;\n  if (name === \"Object\") {\n    return \"custom\";\n  }\n  if (name.endsWith(\"Transport\")) {\n    return name.slice(0, -\"Transport\".length).toLowerCase();\n  }\n  return name.toLowerCase() || \"unknown\";\n}\n\n/** Build hook context from mail options (no body fields). */\nfunction buildHookContext(options: MailOptions, transport: Transport): MailerHookContext {\n  return {\n    ...(options.messageId !== undefined ? { messageId: options.messageId } : {}),\n    to: extractEmails(options.to),\n    subject: options.subject,\n    provider: inferProvider(transport),\n  };\n}\n\n/**\n * Invoke a mailer hook without letting hook failures break the send.\n * In non-production environments, hook errors are logged with `console.warn`.\n */\nasync function invokeHook<T extends unknown[]>(\n  hook: ((...args: T) => void | Promise<void>) | undefined,\n  ...args: T\n): Promise<void> {\n  if (hook === undefined) {\n    return;\n  }\n  try {\n    await hook(...args);\n  } catch (hookError) {\n    const isProduction = typeof process !== \"undefined\" && process.env?.NODE_ENV === \"production\";\n    if (!isProduction) {\n      console.warn(\"[sently] Mailer hook threw; send continues:\", hookError);\n    }\n  }\n}\n\n/** Internal mailer implementation shared with the full `sently` entry. */\nexport class MailerImpl implements Mailer {\n  constructor(\n    private readonly transport: Transport,\n    private readonly plugins: MailPlugin[] = [],\n    private readonly hooks?: MailerHooks,\n  ) {}\n\n  async send(options: MailOptions): Promise<SendResult> {\n    const processed = await runPlugins(options, this.plugins);\n    const ctx = buildHookContext(processed, this.transport);\n\n    await invokeHook(this.hooks?.onSend, ctx);\n\n    if (this.hooks?.onRetry !== undefined && isRetryHookTransport(this.transport)) {\n      this.transport.setMailerOnRetry((attempt, error) => {\n        void invokeHook(this.hooks?.onRetry, ctx, attempt, error);\n      });\n    }\n\n    try {\n      const result = await this.transport.send(processed);\n      const successCtx: MailerHookContext = {\n        ...ctx,\n        messageId: result.messageId,\n      };\n      await invokeHook(this.hooks?.onSuccess, successCtx, result);\n      return result;\n    } catch (error) {\n      await invokeHook(this.hooks?.onError, ctx, error);\n      throw error;\n    } finally {\n      if (isRetryHookTransport(this.transport)) {\n        this.transport.setMailerOnRetry(undefined);\n      }\n    }\n  }\n\n  private async processMessage(message: MailOptions): Promise<MailOptions> {\n    return runPlugins(message, this.plugins);\n  }\n\n  async sendBulk(messages: MailOptions[], options?: BulkSendOptions): Promise<BulkSendResult> {\n    if (messages.length === 0) {\n      return { total: 0, sent: 0, failed: 0, results: [] };\n    }\n\n    const results: BulkSendResult[\"results\"] = new Array(messages.length);\n    const stopOnError = options?.stopOnError ?? false;\n    let halted = false;\n\n    const recordSuccess = async (\n      message: MailOptions,\n      index: number,\n      result: SendResult,\n      processed?: MailOptions,\n    ): Promise<void> => {\n      results[index] = { status: \"sent\", result };\n      if (processed !== undefined && this.hooks !== undefined) {\n        const ctx = buildHookContext(processed, this.transport);\n        await invokeHook(this.hooks.onSend, ctx);\n        await invokeHook(this.hooks.onSuccess, { ...ctx, messageId: result.messageId }, result);\n      }\n      options?.onSuccess?.(message, index, result);\n    };\n\n    const recordFailure = async (\n      message: MailOptions,\n      index: number,\n      error: unknown,\n      processed?: MailOptions,\n    ): Promise<void> => {\n      results[index] = { status: \"failed\", error };\n      if (processed !== undefined && this.hooks !== undefined) {\n        const ctx = buildHookContext(processed, this.transport);\n        await invokeHook(this.hooks.onSend, ctx);\n        await invokeHook(this.hooks.onError, ctx, error);\n      }\n      options?.onError?.(message, index, error);\n      if (stopOnError) {\n        halted = true;\n      }\n    };\n\n    if (this.transport.sendBatch) {\n      const batchEntries: Array<{ index: number; message: MailOptions }> = [];\n      const singleEntries: Array<{ index: number; message: MailOptions }> = [];\n\n      for (const [index, message] of messages.entries()) {\n        if (hasAttachments(message)) {\n          singleEntries.push({ index, message });\n        } else {\n          batchEntries.push({ index, message });\n        }\n      }\n\n      if (batchEntries.length > 0 && !halted) {\n        const chunkSize = this.transport.batchMax ?? batchEntries.length;\n        const rateDelta = options?.rateDelta ?? 2;\n        const rateLimiter =\n          rateDelta > 0\n            ? new RateLimiter(rateDelta, options?.rateLimit ?? 1000, options?.now)\n            : null;\n\n        for (\n          let chunkStart = 0;\n          chunkStart < batchEntries.length && !halted;\n          chunkStart += chunkSize\n        ) {\n          const chunk = batchEntries.slice(chunkStart, chunkStart + chunkSize);\n\n          if (rateLimiter) {\n            await rateLimiter.acquire();\n          }\n\n          try {\n            const processed = await Promise.all(\n              chunk.map(({ message }) => this.processMessage(message)),\n            );\n            const batchResults = await this.transport.sendBatch(processed);\n\n            for (let i = 0; i < chunk.length; i++) {\n              const entry = chunk[i] as { index: number; message: MailOptions };\n              const processedMessage = processed[i] as MailOptions;\n              const result = batchResults[i];\n              if (result === undefined) {\n                await recordFailure(\n                  entry.message,\n                  entry.index,\n                  new Error(\"Batch response missing result for message\"),\n                  processedMessage,\n                );\n              } else if (result.batchError !== undefined) {\n                await recordFailure(\n                  entry.message,\n                  entry.index,\n                  result.batchError,\n                  processedMessage,\n                );\n              } else {\n                await recordSuccess(entry.message, entry.index, result, processedMessage);\n              }\n            }\n          } catch (error) {\n            const processed = await Promise.all(\n              chunk.map(({ message }) => this.processMessage(message)),\n            );\n            for (let i = 0; i < chunk.length; i++) {\n              if (halted) {\n                break;\n              }\n              const entry = chunk[i] as { index: number; message: MailOptions };\n              await recordFailure(entry.message, entry.index, error, processed[i]);\n            }\n          }\n        }\n      }\n\n      if (singleEntries.length > 0 && !halted) {\n        const concurrency = options?.concurrency ?? 1;\n        const queue = [...singleEntries];\n        let active = 0;\n\n        await new Promise<void>((resolve) => {\n          const maybeDone = (): void => {\n            if ((queue.length === 0 && active === 0) || halted) {\n              resolve();\n            }\n          };\n\n          const processNext = (): void => {\n            if (queue.length === 0 || halted) {\n              maybeDone();\n              return;\n            }\n\n            const entry = queue.shift();\n            if (entry === undefined) {\n              maybeDone();\n              return;\n            }\n\n            active++;\n            void this.send(entry.message)\n              .then((result) => {\n                results[entry.index] = { status: \"sent\", result };\n                options?.onSuccess?.(entry.message, entry.index, result);\n              })\n              .catch((error: unknown) => {\n                results[entry.index] = { status: \"failed\", error };\n                options?.onError?.(entry.message, entry.index, error);\n                if (stopOnError) {\n                  halted = true;\n                }\n              })\n              .finally(() => {\n                active--;\n                processNext();\n                maybeDone();\n              });\n          };\n\n          for (let i = 0; i < concurrency; i++) {\n            processNext();\n          }\n        });\n      }\n    } else {\n      const concurrency = options?.concurrency ?? 1;\n      const queue = [...messages.entries()];\n      let active = 0;\n\n      await new Promise<void>((resolve) => {\n        const maybeDone = (): void => {\n          if ((queue.length === 0 && active === 0) || halted) {\n            resolve();\n          }\n        };\n\n        const processNext = (): void => {\n          if (queue.length === 0 || halted) {\n            maybeDone();\n            return;\n          }\n\n          const entry = queue.shift();\n          if (entry === undefined) {\n            maybeDone();\n            return;\n          }\n\n          const [index, message] = entry;\n          active++;\n\n          void this.send(message)\n            .then((result) => {\n              results[index] = { status: \"sent\", result };\n              options?.onSuccess?.(message, index, result);\n            })\n            .catch((error: unknown) => {\n              results[index] = { status: \"failed\", error };\n              options?.onError?.(message, index, error);\n              if (stopOnError) {\n                halted = true;\n              }\n            })\n            .finally(() => {\n              active--;\n              processNext();\n              maybeDone();\n            });\n        };\n\n        for (let i = 0; i < concurrency; i++) {\n          processNext();\n        }\n      });\n    }\n\n    let sent = 0;\n    let failed = 0;\n    for (const result of results) {\n      if (result === undefined) {\n        continue;\n      }\n      if (result.status === \"sent\") {\n        sent++;\n      } else {\n        failed++;\n      }\n    }\n\n    return {\n      total: messages.length,\n      sent,\n      failed,\n      results,\n    };\n  }\n\n  verify(): Promise<VerifyResult> {\n    if (this.transport.verify) {\n      return this.transport.verify();\n    }\n    return Promise.resolve({ ok: true, provider: \"mailer\" });\n  }\n\n  close(): Promise<void> {\n    if (this.transport.close) {\n      return this.transport.close();\n    }\n    return Promise.resolve();\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C3B38A0E65479A2E64756E2164756E21",
+  "names": []
+}

package/dist/core/errors.d.ts

@@ -3,7 +3,7 @@
  * Unified error hierarchy for sently transports and SMTP.
  */
 /** Stable machine-readable error codes shared across providers. */
-export type SentlyErrorCode = "SMTP_AUTH_FAILED" | "RATE_LIMITED" | "TIMEOUT" | "CONNECTION_FAILED" | "PROVIDER_ERROR" | "BAD_REQUEST";
+export type SentlyErrorCode = "INVALID_CONFIG" | "SMTP_AUTH_FAILED" | "RATE_LIMITED" | "TIMEOUT" | "CONNECTION_FAILED" | "PROVIDER_ERROR" | "BAD_REQUEST";
 /** Options for constructing a {@link SentlyError}. */
 export interface SentlyErrorOptions {
     /** HTTP status code when the failure originated from an HTTP transport. */

package/dist/core/types.d.ts

@@ -280,7 +280,7 @@ export interface BulkSendOptions {
     onSuccess?: (message: MailOptions, index: number, result: SendResult) => void;
     /** Callback fired after each failed send (does not throw) */
     onError?: (message: MailOptions, index: number, error: unknown) => void;
-    /** Max concurrent sends. Defaults to pool maxConnections or 1 */
+    /** Max concurrent sends. Defaults to 1. */
     concurrency?: number;
     /** When true, stop sending after the first failure. Default: false */
     stopOnError?: boolean;
@@ -378,13 +378,10 @@ export interface TransportMailerOptions {
     /** Optional lifecycle hooks for metrics and tracing on every send. */
     hooks?: MailerHooks;
 }
-/**
- * Legacy union for transport or SMTP mailer options.
- * Use {@link TransportMailerOptions} with `sently/mailer` or SMTP config with `sently/smtp`.
- */
-export type CreateMailerOptions = TransportMailerOptions | (SMTPConfig & {
+/** Options for {@link createSMTPMailer} from `sently/smtp` or the main barrel. */
+export type SMTPMailerOptions = SMTPConfig & {
     hooks?: MailerHooks;
-});
+};
 /**
  * A mail plugin transforms MailOptions before the message is built.
  * Plugins run sequentially. Each receives the output of the previous.

package/dist/index.d.ts

@@ -1,14 +1,17 @@
 /**
  * @module
- * Main sently entrypoint — runtime detection, mailer factory, and shared types.
+ * Main sently entrypoint — shared types, mailer factories, runtime detection, and OAuth2.
+ *
+ * Import transports, webhooks, idempotency, DKIM, and plugins from their subpaths
+ * (e.g. `sently/transports/resend`, `sently/webhooks`) for the smallest bundle.
  *
  * @example
  * ```ts
- * import { createMailer } from "sently/smtp";
+ * import { createMailer } from "sently/mailer";
+ * import { ResendTransport } from "sently/transports/resend";
  *
  * const mailer = await createMailer({
- *   host: "smtp.example.com",
- *   auth: { user: "you@example.com", pass: "secret" },
+ *   transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),
  * });
  *
  * await mailer.send({
@@ -34,106 +37,13 @@ httpStatusToSentlyCode,
 SentlyError, 
 /** Map an SMTP response code to a stable sently error code. */
 smtpCodeToSentlyCode, } from "./core/errors.js";
-export { 
-/** SMTP protocol error with server response details. */
-SMTPError, } from "./core/smtp.js";
-export type { Address, AddressInput, Attachment, BrevoConfig, BulkSendOptions, BulkSendResult, CreateMailerOptions, DKIMConfig, Envelope, Mailer, MailerHookContext, MailerHooks, MailgunConfig, MailOptions, MailPlugin, OAuth2Config, PoolConfig, PreviewConfig, RetryConfig, Runtime, SESConfig, SendResult, SMTPAuth, SMTPConfig, SocketAdapter, TLSOptions, Transport, TransportMailerOptions, VerifyResult, } from "./core/types.js";
+export type { Address, AddressInput, Attachment, BrevoConfig, BulkSendOptions, BulkSendResult, DKIMConfig, Envelope, Mailer, MailerHookContext, MailerHooks, MailgunConfig, MailOptions, MailPlugin, OAuth2Config, PoolConfig, PreviewConfig, RetryConfig, Runtime, SESConfig, SendResult, SMTPAuth, SMTPConfig, SMTPMailerOptions, SocketAdapter, TLSOptions, Transport, TransportMailerOptions, VerifyResult, } from "./core/types.js";
 export { 
 /** Detect the current JavaScript runtime. */
 detectRuntime, } from "./detect.js";
-export type { DKIMSignResult } from "./dkim.js";
-export { 
-/** Import a PEM private key for DKIM signing. */
-importPrivateKey, 
-/** Sign a raw MIME message with DKIM (RFC 6376). */
-signDKIM, } from "./dkim.js";
-export type { 
-/** Key-value store for idempotency deduplication. */
-IdempotencyStore, 
-/** Options for {@link IdempotencyTransport}. */
-IdempotencyTransportOptions, } from "./idempotency.js";
-export { 
-/** Transport decorator that deduplicates sends on retry or replay. */
-IdempotencyTransport, 
-/** In-memory idempotency store with optional TTL expiry. */
-MemoryIdempotencyStore, } from "./idempotency.js";
 export { 
 /** Create a mailer for custom transports (HTTP APIs, preview, retry). Prefer `sently/mailer` for smallest bundles. */
 createMailer, } from "./mailer.js";
-export type { 
-/** Renders a template string with the given data object. */
-TemplateEngine, 
-/** Configuration for the template plugin. */
-TemplatePluginConfig, } from "./plugins/template.js";
 export { 
-/** Built-in zero-dependency template engine using `{{variable}}` interpolation. */
-simpleEngine, 
-/** Create a template plugin that renders HTML from a named template and data. */
-templatePlugin, } from "./plugins/template.js";
-export { 
-/** SMTP connection pool with optional rate limiting. */
-SMTPPool, } from "./pool/pool.js";
-export { 
-/** Create a mailer from SMTP host/port config (pooling, adapters). */
+/** Create a mailer from SMTP host/port config (pooling, adapters). Prefer `sently/smtp` for smallest SMTP bundles. */
 createSMTPMailer, } from "./smtp-mailer.js";
-export { 
-/** Error thrown when the Brevo API returns a non-success response. */
-BrevoError, 
-/** Brevo HTTP API transport. */
-BrevoTransport, } from "./transports/brevo.js";
-export { 
-/** Error thrown when the Mailgun API returns a non-success response. */
-MailgunError, 
-/** Mailgun HTTP API transport (multipart/form-data). */
-MailgunTransport, } from "./transports/mailgun.js";
-export { 
-/** Error thrown when the Postmark API returns a non-success response. */
-PostmarkError, 
-/** Postmark HTTP API transport. */
-PostmarkTransport, } from "./transports/postmark.js";
-export { 
-/** Development transport that writes emails to disk instead of sending them. */
-PreviewTransport, } from "./transports/preview.js";
-export { 
-/** Maximum messages per Resend batch request. */
-RESEND_BATCH_MAX, 
-/** Error thrown when the Resend API returns a non-success response. */
-ResendError, 
-/** Resend HTTP API transport. */
-ResendTransport, } from "./transports/resend.js";
-export { 
-/** Decorator transport that retries failed sends with configurable backoff. */
-RetryTransport, } from "./transports/retry.js";
-export { 
-/** Error thrown when the SendGrid API returns a non-success response. */
-SendGridError, 
-/** SendGrid v3 HTTP API transport. */
-SendGridTransport, } from "./transports/sendgrid.js";
-export { 
-/** Error thrown when the AWS SES API returns a non-success response. */
-SESError, 
-/** AWS SES v2 HTTP API transport. */
-SESTransport, } from "./transports/ses.js";
-export { 
-/** SMTP transport orchestrating adapter, MIME builder, and protocol logic. */
-SMTPTransport, } from "./transports/smtp.js";
-export type { EmailEvent } from "./webhooks.js";
-export { 
-/** Parse a Brevo webhook payload into normalized email events. */
-parseBrevoWebhook, 
-/** Parse a Mailgun webhook payload into normalized email events. */
-parseMailgunWebhook, 
-/** Parse a Postmark webhook payload into normalized email events. */
-parsePostmarkWebhook, 
-/** Parse a Resend webhook payload into normalized email events. */
-parseResendWebhook, 
-/** Parse a SendGrid Event Webhook payload into normalized email events. */
-parseSendGridWebhook, 
-/** Parse an AWS SES SNS webhook payload into normalized email events. */
-parseSesWebhook, 
-/** Verify a Mailgun webhook using the nested signature object. */
-verifyMailgunPayload, 
-/** Verify a Mailgun webhook HMAC signature. */
-verifyMailgunSignature, 
-/** Verify a Resend webhook Svix-style signature. */
-verifyResendSignature, } from "./webhooks.js";

package/dist/index.js

@@ -15,116 +15,16 @@ export {
   
   smtpCodeToSentlyCode,
 } from "./core/errors.js";
-export {
-  
-  SMTPError,
-} from "./core/smtp.js";
 
 export {
   
   detectRuntime,
 } from "./detect.js";
-
-export {
-  
-  importPrivateKey,
-  
-  signDKIM,
-} from "./dkim.js";
-
-export {
-  
-  IdempotencyTransport,
-  
-  MemoryIdempotencyStore,
-} from "./idempotency.js";
 export {
   
   createMailer,
 } from "./mailer.js";
-
-export {
-  
-  simpleEngine,
-  
-  templatePlugin,
-} from "./plugins/template.js";
-export {
-  
-  SMTPPool,
-} from "./pool/pool.js";
 export {
   
   createSMTPMailer,
 } from "./smtp-mailer.js";
-export {
-  
-  BrevoError,
-  
-  BrevoTransport,
-} from "./transports/brevo.js";
-export {
-  
-  MailgunError,
-  
-  MailgunTransport,
-} from "./transports/mailgun.js";
-export {
-  
-  PostmarkError,
-  
-  PostmarkTransport,
-} from "./transports/postmark.js";
-export {
-  
-  PreviewTransport,
-} from "./transports/preview.js";
-export {
-  
-  RESEND_BATCH_MAX,
-  
-  ResendError,
-  
-  ResendTransport,
-} from "./transports/resend.js";
-export {
-  
-  RetryTransport,
-} from "./transports/retry.js";
-export {
-  
-  SendGridError,
-  
-  SendGridTransport,
-} from "./transports/sendgrid.js";
-export {
-  
-  SESError,
-  
-  SESTransport,
-} from "./transports/ses.js";
-export {
-  
-  SMTPTransport,
-} from "./transports/smtp.js";
-
-export {
-  
-  parseBrevoWebhook,
-  
-  parseMailgunWebhook,
-  
-  parsePostmarkWebhook,
-  
-  parseResendWebhook,
-  
-  parseSendGridWebhook,
-  
-  parseSesWebhook,
-  
-  verifyMailgunPayload,
-  
-  verifyMailgunSignature,
-  
-  verifyResendSignature,
-} from "./webhooks.js";

package/dist/mailer.js

@@ -1,3 +1,3 @@
-import{v as a,w as b}from"./chunk-vae5rfb1.js";import"./chunk-kebhy657.js";import"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import"./chunk-keksa6fx.js";export{a as createMailer,b as MailerImpl};
+import{v as a,w as b}from"./chunk-ka6t8g77.js";import"./chunk-kebhy657.js";import"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import"./chunk-a1c87hn1.js";import"./chunk-keksa6fx.js";export{a as createMailer,b as MailerImpl};
 
-//# debugId=9B27A1190250EBEC64756E2164756E21
+//# debugId=473A1A6D56DBB5E664756E2164756E21

package/dist/mailer.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "9B27A1190250EBEC64756E2164756E21",
+  "debugId": "473A1A6D56DBB5E664756E2164756E21",
   "names": []
 }

package/dist/pool/pool.js

@@ -1,3 +1,3 @@
-import{i as B,j as Q,k as U,l as V}from"../chunk-fjq6b8gj.js";import"../chunk-rm78s1ek.js";import{r as K}from"../chunk-gkkv7yqm.js";import{s as N}from"../chunk-r7ee9tk7.js";import{x as G}from"../chunk-kebhy657.js";import"../chunk-gh5n759p.js";import"../chunk-cvrbfke9.js";import"../chunk-d5rwm3br.js";import"../chunk-a1c87hn1.js";import"../chunk-keksa6fx.js";async function W(k){let q=B(k.config),w=await k.createAdapter();await w.connect(k.connectHost,q.port),await Q(w,q);let z=0,D=!0,F=Promise.resolve(),X=k.maxMessages;return{get idle(){return D},get messageCount(){return z},get usable(){return z<X},async send(H){let Y=async()=>{D=!1;try{let Z={...H,attachments:await N(H.attachments)},_=await K(Z,q.dkim),$=await U(w,_);return z+=1,$}finally{D=!0}},J=F.then(Y);return F=J.then(()=>{return},()=>{return}),J},async close(){await F,await V(w)}}}class b{config;maxConnections;maxMessages;createAdapterFn;rateLimiter;connections=[];queue=[];draining=!1;closed=!1;processChain=Promise.resolve();constructor(k,q){if(this.config=k,this.maxConnections=k.maxConnections??5,this.maxMessages=k.maxMessages??100,q?.createAdapter){let w=q.createAdapter;this.createAdapterFn=async()=>w()}else if(k.adapter)this.createAdapterFn=async()=>k.adapter;else throw Error("SMTPPool requires config.adapter or options.createAdapter");if(k.rateDelta!==void 0&&k.rateDelta>0)this.rateLimiter=new G(k.rateDelta,k.rateLimit??1000,q?.now);else this.rateLimiter=null}async send(k){if(this.draining)throw Error("SMTPPool is closing — no new messages accepted");if(this.closed)throw Error("SMTPPool is closed");if(this.rateLimiter)await this.rateLimiter.acquire();return new Promise((q,w)=>{this.queue.push({options:k,resolve:q,reject:w}),this.scheduleProcess()})}scheduleProcess(){this.processChain=this.processChain.then(()=>this.processQueue()).catch(()=>{return})}async verify(){try{let k=await this.spawnConnection();try{return{ok:!0,provider:"smtp-pool"}}finally{await k.close(),this.removeConnection(k)}}catch(k){return{ok:!1,provider:"smtp-pool",message:k instanceof Error?k.message:String(k)}}}async close(){this.draining=!0,await this.drainQueue(),await Promise.allSettled(this.connections.map((k)=>k.close())),this.connections.length=0,this.closed=!0}get connectionCount(){return this.connections.length}get queueSize(){return this.queue.length}async processQueue(){if(this.draining)return;while(this.queue.length>0){let k=this.connections.find((q)=>q.idle&&q.usable);if(k){let q=this.queue.shift();if(!q)break;try{let w=await k.send(q.options);if(q.resolve(w),!k.usable)await k.close(),this.removeConnection(k)}catch(w){q.reject(w),await k.close().catch(()=>{return}),this.removeConnection(k)}continue}if(this.connections.length<this.maxConnections){let q=this.queue.shift();if(!q)break;let w=await this.spawnConnection();try{let z=await w.send(q.options);if(q.resolve(z),!w.usable)await w.close(),this.removeConnection(w)}catch(z){q.reject(z),await w.close().catch(()=>{return}),this.removeConnection(w)}continue}break}}async spawnConnection(){let k=B(this.config),q=await W({config:this.config,maxMessages:this.maxMessages,connectHost:k.host,createAdapter:this.createAdapterFn});return this.connections.push(q),q}removeConnection(k){let q=this.connections.indexOf(k);if(q>=0)this.connections.splice(q,1)}async drainQueue(){while(this.queue.length>0||this.connections.some((k)=>!k.idle))if(await this.processQueue(),this.queue.length>0)await new Promise((k)=>setTimeout(k,10))}}export{b as SMTPPool,G as RateLimiter};
+import{i as B,j as Q,k as U,l as V}from"../chunk-4mvp3b85.js";import"../chunk-rm78s1ek.js";import{r as K}from"../chunk-gkkv7yqm.js";import{s as N}from"../chunk-r7ee9tk7.js";import{x as G}from"../chunk-kebhy657.js";import"../chunk-gh5n759p.js";import"../chunk-cvrbfke9.js";import"../chunk-d5rwm3br.js";import"../chunk-a1c87hn1.js";import"../chunk-keksa6fx.js";async function W(k){let q=B(k.config),w=await k.createAdapter();await w.connect(k.connectHost,q.port),await Q(w,q);let z=0,D=!0,F=Promise.resolve(),X=k.maxMessages;return{get idle(){return D},get messageCount(){return z},get usable(){return z<X},async send(H){let Y=async()=>{D=!1;try{let Z={...H,attachments:await N(H.attachments)},_=await K(Z,q.dkim),$=await U(w,_);return z+=1,$}finally{D=!0}},J=F.then(Y);return F=J.then(()=>{return},()=>{return}),J},async close(){await F,await V(w)}}}class b{config;maxConnections;maxMessages;createAdapterFn;rateLimiter;connections=[];queue=[];draining=!1;closed=!1;processChain=Promise.resolve();constructor(k,q){if(this.config=k,this.maxConnections=k.maxConnections??5,this.maxMessages=k.maxMessages??100,q?.createAdapter){let w=q.createAdapter;this.createAdapterFn=async()=>w()}else if(k.adapter)this.createAdapterFn=async()=>k.adapter;else throw Error("SMTPPool requires config.adapter or options.createAdapter");if(k.rateDelta!==void 0&&k.rateDelta>0)this.rateLimiter=new G(k.rateDelta,k.rateLimit??1000,q?.now);else this.rateLimiter=null}async send(k){if(this.draining)throw Error("SMTPPool is closing — no new messages accepted");if(this.closed)throw Error("SMTPPool is closed");if(this.rateLimiter)await this.rateLimiter.acquire();return new Promise((q,w)=>{this.queue.push({options:k,resolve:q,reject:w}),this.scheduleProcess()})}scheduleProcess(){this.processChain=this.processChain.then(()=>this.processQueue()).catch(()=>{return})}async verify(){try{let k=await this.spawnConnection();try{return{ok:!0,provider:"smtp-pool"}}finally{await k.close(),this.removeConnection(k)}}catch(k){return{ok:!1,provider:"smtp-pool",message:k instanceof Error?k.message:String(k)}}}async close(){this.draining=!0,await this.drainQueue(),await Promise.allSettled(this.connections.map((k)=>k.close())),this.connections.length=0,this.closed=!0}get connectionCount(){return this.connections.length}get queueSize(){return this.queue.length}async processQueue(){if(this.draining)return;while(this.queue.length>0){let k=this.connections.find((q)=>q.idle&&q.usable);if(k){let q=this.queue.shift();if(!q)break;try{let w=await k.send(q.options);if(q.resolve(w),!k.usable)await k.close(),this.removeConnection(k)}catch(w){q.reject(w),await k.close().catch(()=>{return}),this.removeConnection(k)}continue}if(this.connections.length<this.maxConnections){let q=this.queue.shift();if(!q)break;let w=await this.spawnConnection();try{let z=await w.send(q.options);if(q.resolve(z),!w.usable)await w.close(),this.removeConnection(w)}catch(z){q.reject(z),await w.close().catch(()=>{return}),this.removeConnection(w)}continue}break}}async spawnConnection(){let k=B(this.config),q=await W({config:this.config,maxMessages:this.maxMessages,connectHost:k.host,createAdapter:this.createAdapterFn});return this.connections.push(q),q}removeConnection(k){let q=this.connections.indexOf(k);if(q>=0)this.connections.splice(q,1)}async drainQueue(){while(this.queue.length>0||this.connections.some((k)=>!k.idle))if(await this.processQueue(),this.queue.length>0)await new Promise((k)=>setTimeout(k,10))}}export{b as SMTPPool,G as RateLimiter};
 
 //# debugId=EEBF20CE45142C1F64756E2164756E21

package/dist/smtp-mailer.d.ts

@@ -7,21 +7,17 @@
  *
  * @example
  * ```ts
- * import { createMailer } from "sently/smtp";
+ * import { createSMTPMailer } from "sently/smtp";
  *
- * const mailer = await createMailer({
+ * const mailer = await createSMTPMailer({
  *   host: "smtp.example.com",
  *   port: 587,
  *   auth: { user: "you@example.com", pass: "secret" },
  * });
  * ```
  */
-import type { Mailer, MailerHooks, SMTPConfig } from "./core/types.js";
+import type { Mailer, SMTPMailerOptions } from "./core/types.js";
 /**
  * Create a mailer from SMTP relay options (host, port, auth, pool, adapter).
  */
-export declare function createSMTPMailer(options: SMTPConfig & {
-    hooks?: MailerHooks;
-}): Promise<Mailer>;
-/** Alias for {@link createSMTPMailer} — preferred import path is `sently/smtp`. */
-export declare const createMailer: typeof createSMTPMailer;
+export declare function createSMTPMailer(options: SMTPMailerOptions): Promise<Mailer>;

package/dist/smtp-mailer.js

@@ -1,3 +1,3 @@
-import{u as g}from"./chunk-74rha3ac.js";import{w as q}from"./chunk-vae5rfb1.js";import"./chunk-kebhy657.js";import"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import{W as w}from"./chunk-keksa6fx.js";async function C(b){let v={...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:B}=await import("./pool/pool.js");return new q(new B(b,{createAdapter:async()=>b.adapter??await g(v)}),b.plugins,b.hooks)}let x=b.adapter??await g(v),{SMTPTransport:z}=await import("./transports/smtp.js");return new q(new z({...b,adapter:x}),b.plugins,b.hooks)}var G=C;export{C as createSMTPMailer,G as createMailer};
+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};
 
-//# debugId=7A21688D4CA004A464756E2164756E21
+//# debugId=A5A864CB09BE2C3364756E2164756E21

package/dist/smtp-mailer.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/smtp-mailer.ts"],
   "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 { createMailer } from \"sently/smtp\";\n *\n * const mailer = await createMailer({\n *   host: \"smtp.example.com\",\n *   port: 587,\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { Mailer, MailerHooks, SMTPConfig } 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(\n  options: SMTPConfig & { hooks?: MailerHooks },\n): 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\n/** Alias for {@link createSMTPMailer} — preferred import path is `sently/smtp`. */\nexport const createMailer = createSMTPMailer;\n"
+    "/**\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": "0OAyBA,SAAsB,LAAgB,LACpC,JACiB,LACjB,IAAM,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,EAI3F,IAAM,EAAe",
-  "debugId": "7A21688D4CA004A464756E2164756E21",
+  "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",
   "names": []
 }

package/dist/transports/brevo.js.map

@@ -2,7 +2,7 @@
   "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\";\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  /** 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",

package/dist/transports/mailgun.js.map

@@ -2,7 +2,7 @@
   "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\";\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  /** 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",

package/dist/transports/postmark.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/transports/postmark.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Postmark HTTP API transport for sending email via api.postmarkapp.com.\n *\n * @example\n * ```ts\n * import { PostmarkTransport } from \"sently/transports/postmark\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new PostmarkTransport({ serverToken: process.env.POSTMARK_TOKEN! }),\n * });\n *\n * await mailer.send({\n *   from: \"sender@example.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   text: \"Plain text body\",\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 { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Postmark API configuration. */\nexport interface PostmarkConfig {\n  /** Postmark server API token. */\n  serverToken: string;\n}\n\n/** Error thrown when the Postmark API returns a non-success response. */\nexport class PostmarkError extends SentlyError {\n  /** Creates a Postmark 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: \"postmark\",\n      cause: apiError,\n    });\n    this.name = \"PostmarkError\";\n  }\n}\n\n/**\n * Postmark HTTP API transport.\n */\nexport class PostmarkTransport implements Transport {\n  /** Postmark server API token for the X-Postmark-Server-Token header. */\n  private readonly serverToken: string;\n\n  /** Creates a Postmark transport with the given server token. */\n  constructor(config: PostmarkConfig) {\n    this.serverToken = config.serverToken;\n  }\n\n  /** Sends an email via the Postmark 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 = {\n      From: from ? toMIMEHeader(from) : \"\",\n      To: parseAddresses(options.to).map(toMIMEHeader).join(\", \"),\n      Subject: options.subject,\n      ...(options.cc ? { Cc: parseAddresses(options.cc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.bcc ? { Bcc: parseAddresses(options.bcc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.replyTo\n        ? { ReplyTo: parseAddresses(options.replyTo).map(toMIMEHeader).join(\", \") }\n        : {}),\n      ...(options.text ? { TextBody: options.text } : {}),\n      ...(options.html ? { HtmlBody: options.html } : {}),\n      ...(options.headers\n        ? { Headers: Object.entries(options.headers).map(([Name, Value]) => ({ Name, Value })) }\n        : {}),\n      ...(attachments.length > 0\n        ? {\n            Attachments: 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              ContentType: att.contentType ?? \"application/octet-stream\",\n              ...(att.contentId ? { ContentID: att.contentId } : {}),\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.postmarkapp.com/email\", {\n      method: \"POST\",\n      headers: {\n        \"X-Postmark-Server-Token\": this.serverToken,\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      MessageID?: string;\n      Message?: string;\n      ErrorCode?: number;\n    };\n\n    if (!response.ok) {\n      throw new PostmarkError(payload.Message ?? \"Postmark API error\", response.status, payload);\n    }\n\n    return {\n      messageId: payload.MessageID ?? options.messageId ?? \"\",\n      accepted: extractEmails(options.to),\n      rejected: [],\n      response: payload.Message ?? \"OK\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: [\n          ...extractEmails(options.to),\n          ...(options.cc ? extractEmails(options.cc) : []),\n          ...(options.bcc ? extractEmails(options.bcc) : []),\n        ],\n      },\n    };\n  }\n\n  /** Verifies the Postmark server token by fetching server info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.postmarkapp.com/server\", {\n        headers: {\n          \"X-Postmark-Server-Token\": this.serverToken,\n          Accept: \"application/json\",\n        },\n      });\n\n      const payload = (await response.json()) as { Name?: string; Message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"postmark\",\n          message: payload.Message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"postmark\",\n        ...(payload.Name ? { message: payload.Name } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"postmark\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+    "/**\n * @module\n * Postmark HTTP API transport for sending email via api.postmarkapp.com.\n *\n * @example\n * ```ts\n * import { PostmarkTransport } from \"sently/transports/postmark\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new PostmarkTransport({ serverToken: process.env.POSTMARK_TOKEN! }),\n * });\n *\n * await mailer.send({\n *   from: \"sender@example.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   text: \"Plain text body\",\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 { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Postmark API configuration. */\nexport interface PostmarkConfig {\n  /** Postmark server API token. */\n  serverToken: string;\n}\n\n/** Error thrown when the Postmark API returns a non-success response. */\nexport class PostmarkError extends SentlyError {\n  /** Creates a Postmark 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: \"postmark\",\n      cause: apiError,\n    });\n    this.name = \"PostmarkError\";\n  }\n}\n\n/**\n * Postmark HTTP API transport.\n */\nexport class PostmarkTransport implements Transport {\n  /** Postmark server API token for the X-Postmark-Server-Token header. */\n  private readonly serverToken: string;\n\n  /** Creates a Postmark transport with the given server token. */\n  constructor(config: PostmarkConfig) {\n    this.serverToken = config.serverToken;\n  }\n\n  /** Sends an email via the Postmark 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 = {\n      From: from ? toMIMEHeader(from) : \"\",\n      To: parseAddresses(options.to).map(toMIMEHeader).join(\", \"),\n      Subject: options.subject,\n      ...(options.cc ? { Cc: parseAddresses(options.cc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.bcc ? { Bcc: parseAddresses(options.bcc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.replyTo\n        ? { ReplyTo: parseAddresses(options.replyTo).map(toMIMEHeader).join(\", \") }\n        : {}),\n      ...(options.text ? { TextBody: options.text } : {}),\n      ...(options.html ? { HtmlBody: options.html } : {}),\n      ...(options.headers\n        ? { Headers: Object.entries(options.headers).map(([Name, Value]) => ({ Name, Value })) }\n        : {}),\n      ...(attachments.length > 0\n        ? {\n            Attachments: 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              ContentType: att.contentType ?? \"application/octet-stream\",\n              ...(att.contentId ? { ContentID: att.contentId } : {}),\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.postmarkapp.com/email\", {\n      method: \"POST\",\n      headers: {\n        \"X-Postmark-Server-Token\": this.serverToken,\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      MessageID?: string;\n      Message?: string;\n      ErrorCode?: number;\n    };\n\n    if (!response.ok) {\n      throw new PostmarkError(payload.Message ?? \"Postmark API error\", response.status, payload);\n    }\n\n    return {\n      messageId: payload.MessageID ?? options.messageId ?? \"\",\n      accepted: extractEmails(options.to),\n      rejected: [],\n      response: payload.Message ?? \"OK\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: [\n          ...extractEmails(options.to),\n          ...(options.cc ? extractEmails(options.cc) : []),\n          ...(options.bcc ? extractEmails(options.bcc) : []),\n        ],\n      },\n    };\n  }\n\n  /** Verifies the Postmark server token by fetching server info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.postmarkapp.com/server\", {\n        headers: {\n          \"X-Postmark-Server-Token\": this.serverToken,\n          Accept: \"application/json\",\n        },\n      });\n\n      const payload = (await response.json()) as { Name?: string; Message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"postmark\",\n          message: payload.Message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"postmark\",\n        ...(payload.Name ? { message: payload.Name } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"postmark\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
   ],
   "mappings": "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",
   "debugId": "AC3184841BFF35F464756E2164756E21",