@fmontoya/aws-ses-adapter 1.0.0

package/dist/index.js

@@ -0,0 +1,446 @@
+'use strict';
+
+var clientSes = require('@aws-sdk/client-ses');
+
+// src/adapter.ts
+function buildSesClient(config) {
+  return new clientSes.SESClient({
+    region: config.region,
+    credentials: {
+      accessKeyId: config.accessKeyId,
+      secretAccessKey: config.secretAccessKey
+    }
+  });
+}
+
+// src/errors.ts
+var SesNotInitializedError = class extends Error {
+  constructor() {
+    super(
+      "SES Adapter has not been initialized. Call init() before using any adapter methods."
+    );
+    /** @override */
+    this.name = "SesNotInitializedError";
+  }
+};
+var SesConfigError = class extends Error {
+  /**
+   * @param message - Description of the configuration issue.
+   */
+  constructor(message) {
+    super(message);
+    /** @override */
+    this.name = "SesConfigError";
+  }
+};
+var SesSendError = class extends Error {
+  /**
+   * @param message - Description of the send failure.
+   * @param cause   - The underlying error from AWS SDK.
+   */
+  constructor(message, cause) {
+    super(message, { cause });
+    /** @override */
+    this.name = "SesSendError";
+  }
+};
+var SesValidationError = class extends Error {
+  /**
+   * @param message - Description of the validation failure.
+   */
+  constructor(message) {
+    super(message);
+    /** @override */
+    this.name = "SesValidationError";
+  }
+};
+
+// src/adapter.ts
+function resolveConfig(config = {}) {
+  const region = config.region ?? process.env["AWS_SES_REGION"];
+  const accessKeyId = config.accessKeyId ?? process.env["AWS_ACCESS_KEY_ID"];
+  const secretAccessKey = config.secretAccessKey ?? process.env["AWS_SECRET_ACCESS_KEY"];
+  const defaultFrom = config.defaultFrom ?? process.env["AWS_SES_FROM_EMAIL"];
+  if (!region) {
+    throw new SesConfigError(
+      "AWS SES region is required. Provide it via config.region or the AWS_SES_REGION environment variable."
+    );
+  }
+  if (!accessKeyId) {
+    throw new SesConfigError(
+      "AWS access key ID is required. Provide it via config.accessKeyId or the AWS_ACCESS_KEY_ID environment variable."
+    );
+  }
+  if (!secretAccessKey) {
+    throw new SesConfigError(
+      "AWS secret access key is required. Provide it via config.secretAccessKey or the AWS_SECRET_ACCESS_KEY environment variable."
+    );
+  }
+  return { region, accessKeyId, secretAccessKey, defaultFrom };
+}
+function toArray(value) {
+  return Array.isArray(value) ? value : [value];
+}
+function encodeHeaderValue(value) {
+  if (!/[\u0080-\uFFFF]/.test(value)) return value;
+  return `=?UTF-8?B?${Buffer.from(value, "utf-8").toString("base64")}?=`;
+}
+function buildMimeMessage(options, from) {
+  const mixedBoundary = `----=_Mixed_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+  const altBoundary = `----=_Alt_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+  const lines = [];
+  lines.push(`From: ${from}`);
+  lines.push(`To: ${toArray(options.to).join(", ")}`);
+  if (options.cc) lines.push(`Cc: ${toArray(options.cc).join(", ")}`);
+  if (options.bcc) lines.push(`Bcc: ${toArray(options.bcc).join(", ")}`);
+  if (options.replyTo)
+    lines.push(`Reply-To: ${toArray(options.replyTo).join(", ")}`);
+  lines.push(`Subject: ${encodeHeaderValue(options.subject)}`);
+  lines.push("MIME-Version: 1.0");
+  lines.push(`Content-Type: multipart/mixed; boundary="${mixedBoundary}"`);
+  lines.push("");
+  if (options.html && options.text) {
+    lines.push(`--${mixedBoundary}`);
+    lines.push(
+      `Content-Type: multipart/alternative; boundary="${altBoundary}"`
+    );
+    lines.push("");
+    lines.push(`--${altBoundary}`);
+    lines.push("Content-Type: text/plain; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 8bit");
+    lines.push("");
+    lines.push(options.text);
+    lines.push("");
+    lines.push(`--${altBoundary}`);
+    lines.push("Content-Type: text/html; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 8bit");
+    lines.push("");
+    lines.push(options.html);
+    lines.push("");
+    lines.push(`--${altBoundary}--`);
+    lines.push("");
+  } else if (options.html) {
+    lines.push(`--${mixedBoundary}`);
+    lines.push("Content-Type: text/html; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 8bit");
+    lines.push("");
+    lines.push(options.html);
+    lines.push("");
+  } else if (options.text) {
+    lines.push(`--${mixedBoundary}`);
+    lines.push("Content-Type: text/plain; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 8bit");
+    lines.push("");
+    lines.push(options.text);
+    lines.push("");
+  }
+  for (const attachment of options.attachments) {
+    const encoded = encodeAttachment(attachment);
+    const safeName = attachment.filename.replace(/"/g, "");
+    lines.push(`--${mixedBoundary}`);
+    lines.push(`Content-Type: ${attachment.contentType}; name="${safeName}"`);
+    lines.push("Content-Transfer-Encoding: base64");
+    lines.push(`Content-Disposition: attachment; filename="${safeName}"`);
+    lines.push("");
+    lines.push(encoded.match(/.{1,76}/g)?.join("\r\n") ?? encoded);
+    lines.push("");
+  }
+  lines.push(`--${mixedBoundary}--`);
+  return lines.join("\r\n");
+}
+function encodeAttachment(attachment) {
+  if (Buffer.isBuffer(attachment.content)) {
+    return attachment.content.toString("base64");
+  }
+  return Buffer.from(attachment.content).toString("base64");
+}
+var SesAdapter = class {
+  /**
+   * Creates a new SesAdapter instance.
+   *
+   * @param userConfig - Optional configuration. Missing fields fall back to environment variables.
+   * @throws {SesConfigError} When required configuration fields are missing.
+   */
+  constructor(userConfig = {}) {
+    this.config = resolveConfig(userConfig);
+    this.sesClient = buildSesClient(this.config);
+  }
+  /**
+   * Sends an email using AWS SES.
+   *
+   * At least one of `options.html` or `options.text` must be provided.
+   * If `options.from` is not specified, the `defaultFrom` configured during
+   * initialization is used. If neither is available, the call throws.
+   *
+   * @param options - Email sending options.
+   * @returns A promise resolving to a {@link SendEmailResult}.
+   * @throws {SesValidationError} When required email fields are missing or invalid.
+   * @throws {SesSendError} When the AWS SES API call fails.
+   *
+   * @example
+   * ```ts
+   * const result = await adapter.sendEmail({
+   *   to: ['alice@example.com', 'bob@example.com'],
+   *   subject: 'Hello!',
+   *   html: '<p>Hello World</p>',
+   *   text: 'Hello World',
+   *   cc: 'manager@example.com',
+   * });
+   * ```
+   */
+  async sendEmail(options) {
+    if (!options.html && !options.text) {
+      throw new SesValidationError(
+        'At least one of "html" or "text" must be provided in SendEmailOptions.'
+      );
+    }
+    const from = options.from ?? this.config.defaultFrom;
+    if (!from) {
+      throw new SesValidationError(
+        'A sender address is required. Provide "from" in SendEmailOptions or set "defaultFrom" during init().'
+      );
+    }
+    const toAddresses = toArray(options.to);
+    const params = {
+      Source: from,
+      Destination: {
+        ToAddresses: toAddresses,
+        CcAddresses: options.cc ? toArray(options.cc) : void 0,
+        BccAddresses: options.bcc ? toArray(options.bcc) : void 0
+      },
+      Message: {
+        Subject: {
+          Data: options.subject,
+          Charset: "UTF-8"
+        },
+        Body: {
+          Html: options.html ? { Data: options.html, Charset: "UTF-8" } : void 0,
+          Text: options.text ? { Data: options.text, Charset: "UTF-8" } : void 0
+        }
+      },
+      ReplyToAddresses: options.replyTo ? toArray(options.replyTo) : void 0
+    };
+    try {
+      const command = new clientSes.SendEmailCommand(params);
+      const response = await this.sesClient.send(command);
+      return {
+        success: true,
+        messageId: response.MessageId
+      };
+    } catch (error) {
+      throw new SesSendError(
+        `Failed to send email to ${toAddresses.join(", ")}: ${error instanceof Error ? error.message : String(error)}`,
+        error
+      );
+    }
+  }
+  /**
+   * Sends a raw MIME email using AWS SES.
+   *
+   * Use this method when you need full control over the email format, such as
+   * sending emails with attachments or custom headers.
+   *
+   * @param rawMessage - The raw MIME email message as a string.
+   * @returns A promise resolving to a {@link SendEmailResult}.
+   * @throws {SesValidationError} When the raw message is empty.
+   * @throws {SesSendError} When the AWS SES API call fails.
+   *
+   * @example
+   * ```ts
+   * const mimeMessage = [
+   *   'From: sender@example.com',
+   *   'To: recipient@example.com',
+   *   'Subject: Test',
+   *   'MIME-Version: 1.0',
+   *   'Content-Type: text/plain',
+   *   '',
+   *   'Hello World',
+   * ].join('\r\n');
+   *
+   * const result = await adapter.sendRawEmail(mimeMessage);
+   * ```
+   */
+  async sendRawEmail(rawMessage) {
+    if (!rawMessage || rawMessage.trim().length === 0) {
+      throw new SesValidationError("rawMessage cannot be empty.");
+    }
+    const params = {
+      RawMessage: {
+        Data: Buffer.from(rawMessage)
+      }
+    };
+    try {
+      const command = new clientSes.SendRawEmailCommand(params);
+      const response = await this.sesClient.send(command);
+      return {
+        success: true,
+        messageId: response.MessageId
+      };
+    } catch (error) {
+      throw new SesSendError(
+        `Failed to send raw email: ${error instanceof Error ? error.message : String(error)}`,
+        error
+      );
+    }
+  }
+  /**
+   * Sends an email with one or more file attachments using AWS SES.
+   *
+   * Internally builds a multipart/mixed MIME message and dispatches it via
+   * `SendRawEmailCommand`, giving you full attachment support without needing
+   * to craft raw MIME by hand.
+   *
+   * At least one of `options.html` or `options.text` must be provided.
+   * The `options.attachments` array must contain at least one item.
+   *
+   * @param options - Email options including the attachments array.
+   * @returns A promise resolving to a {@link SendEmailResult}.
+   * @throws {SesValidationError} When required fields are missing or invalid.
+   * @throws {SesSendError} When the AWS SES API call fails.
+   *
+   * @example
+   * ```ts
+   * const result = await adapter.sendEmailWithAttachments({
+   *   to: 'alice@example.com',
+   *   subject: 'Your invoice',
+   *   html: '<p>Please find the invoice attached.</p>',
+   *   attachments: [
+   *     {
+   *       filename: 'invoice.pdf',
+   *       content: fs.readFileSync('./invoice.pdf'),
+   *       contentType: 'application/pdf',
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  async sendEmailWithAttachments(options) {
+    if (!options.html && !options.text) {
+      throw new SesValidationError(
+        'At least one of "html" or "text" must be provided in SendEmailWithAttachmentsOptions.'
+      );
+    }
+    if (!options.attachments || options.attachments.length === 0) {
+      throw new SesValidationError(
+        "At least one attachment must be provided in SendEmailWithAttachmentsOptions.attachments."
+      );
+    }
+    const from = options.from ?? this.config.defaultFrom;
+    if (!from) {
+      throw new SesValidationError(
+        'A sender address is required. Provide "from" in SendEmailWithAttachmentsOptions or set "defaultFrom" during init().'
+      );
+    }
+    const rawMessage = buildMimeMessage(options, from);
+    const toAddresses = toArray(options.to);
+    const params = {
+      RawMessage: {
+        Data: Buffer.from(rawMessage)
+      }
+    };
+    try {
+      const command = new clientSes.SendRawEmailCommand(params);
+      const response = await this.sesClient.send(command);
+      return {
+        success: true,
+        messageId: response.MessageId
+      };
+    } catch (error) {
+      throw new SesSendError(
+        `Failed to send email with attachments to ${toAddresses.join(", ")}: ${error instanceof Error ? error.message : String(error)}`,
+        error
+      );
+    }
+  }
+  /**
+   * Returns whether the adapter has a default "From" address configured.
+   *
+   * @returns `true` if a default from address is available.
+   *
+   * @example
+   * ```ts
+   * if (adapter.hasDefaultFrom()) {
+   *   console.log('Default from:', adapter.getDefaultFrom());
+   * }
+   * ```
+   */
+  hasDefaultFrom() {
+    return !!this.config.defaultFrom;
+  }
+  /**
+   * Returns the default "From" email address, or `undefined` if not set.
+   *
+   * @returns The default sender address, or `undefined`.
+   *
+   * @example
+   * ```ts
+   * const from = adapter.getDefaultFrom();
+   * // => 'noreply@example.com' or undefined
+   * ```
+   */
+  getDefaultFrom() {
+    return this.config.defaultFrom;
+  }
+  /**
+   * Returns the AWS region the adapter is configured to use.
+   *
+   * @returns The AWS region string.
+   *
+   * @example
+   * ```ts
+   * console.log(adapter.getRegion()); // => 'us-east-1'
+   * ```
+   */
+  getRegion() {
+    return this.config.region;
+  }
+};
+
+// src/index.ts
+var _instance = null;
+function getInstance() {
+  if (!_instance) {
+    throw new SesNotInitializedError();
+  }
+  return _instance;
+}
+function init(config = {}) {
+  _instance = new SesAdapter(config);
+}
+async function sendEmail(options) {
+  return getInstance().sendEmail(options);
+}
+async function sendEmailWithAttachments(options) {
+  return getInstance().sendEmailWithAttachments(options);
+}
+async function sendRawEmail(rawMessage) {
+  return getInstance().sendRawEmail(rawMessage);
+}
+function isInitialized() {
+  return _instance !== null;
+}
+function hasDefaultFrom() {
+  return getInstance().hasDefaultFrom();
+}
+function getDefaultFrom() {
+  return getInstance().getDefaultFrom();
+}
+function getRegion() {
+  return getInstance().getRegion();
+}
+
+exports.SesAdapter = SesAdapter;
+exports.SesConfigError = SesConfigError;
+exports.SesNotInitializedError = SesNotInitializedError;
+exports.SesSendError = SesSendError;
+exports.SesValidationError = SesValidationError;
+exports.getDefaultFrom = getDefaultFrom;
+exports.getRegion = getRegion;
+exports.hasDefaultFrom = hasDefaultFrom;
+exports.init = init;
+exports.isInitialized = isInitialized;
+exports.sendEmail = sendEmail;
+exports.sendEmailWithAttachments = sendEmailWithAttachments;
+exports.sendRawEmail = sendRawEmail;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/errors.ts","../src/adapter.ts","../src/index.ts"],"names":["SESClient","SendEmailCommand","SendRawEmailCommand"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module client\n * Factory and utilities for building an AWS SESClient instance\n * from a resolved adapter configuration.\n */\n\nimport { SESClient } from '@aws-sdk/client-ses';\nimport type { ResolvedSesAdapterConfig } from './types.js';\n\n/**\n * Creates and returns a configured {@link SESClient} instance using the\n * resolved adapter configuration.\n *\n * @param config - The resolved configuration containing region and credentials.\n * @returns A ready-to-use AWS SESClient.\n *\n * @example\n * ```ts\n * const client = buildSesClient({\n *   region: 'us-east-1',\n *   accessKeyId: 'AKIAIOSFODNN7EXAMPLE',\n *   secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',\n * });\n * ```\n *\n * @internal\n */\nexport function buildSesClient(config: ResolvedSesAdapterConfig): SESClient {\n  return new SESClient({\n    region: config.region,\n    credentials: {\n      accessKeyId: config.accessKeyId,\n      secretAccessKey: config.secretAccessKey,\n    },\n  });\n}\n","/**\n * @module errors\n * Custom error classes for the aws-ses-adapter library.\n * All errors extend the native `Error` class and include a `name` property\n * suitable for programmatic error identification.\n */\n\n/**\n * Thrown when an operation is attempted before the adapter has been initialized\n * via {@link init}.\n *\n * @example\n * ```ts\n * import { sendEmail } from 'aws-ses-adapter';\n *\n * // Calling sendEmail before init() throws this error\n * try {\n *   await sendEmail({ to: 'user@example.com', subject: 'Hi', text: 'Hello' });\n * } catch (err) {\n *   if (err instanceof SesNotInitializedError) {\n *     console.error('Call init() first');\n *   }\n * }\n * ```\n */\nexport class SesNotInitializedError extends Error {\n  /** @override */\n  readonly name = 'SesNotInitializedError' as const;\n\n  constructor() {\n    super(\n      'SES Adapter has not been initialized. Call init() before using any adapter methods.',\n    );\n  }\n}\n\n/**\n * Thrown when the configuration provided to {@link init} is invalid or incomplete.\n * This typically happens when required credentials are missing from both the config\n * object and the environment variables.\n *\n * @example\n * ```ts\n * import { init } from 'aws-ses-adapter';\n *\n * try {\n *   init({}); // No region, no env vars set\n * } catch (err) {\n *   if (err instanceof SesConfigError) {\n *     console.error('Config error:', err.message);\n *   }\n * }\n * ```\n */\nexport class SesConfigError extends Error {\n  /** @override */\n  readonly name = 'SesConfigError' as const;\n\n  /**\n   * @param message - Description of the configuration issue.\n   */\n  constructor(message: string) {\n    super(message);\n  }\n}\n\n/**\n * Thrown when an email send operation fails at the AWS SES level.\n * The original AWS error is available via the `cause` property (ES2022+).\n *\n * @example\n * ```ts\n * import { sendEmail, SesSendError } from 'aws-ses-adapter';\n *\n * try {\n *   await sendEmail({ to: 'user@example.com', subject: 'Hi', text: 'Hello' });\n * } catch (err) {\n *   if (err instanceof SesSendError) {\n *     console.error('Send failed:', err.message);\n *     console.error('Original cause:', err.cause);\n *   }\n * }\n * ```\n */\nexport class SesSendError extends Error {\n  /** @override */\n  readonly name = 'SesSendError' as const;\n\n  /**\n   * @param message - Description of the send failure.\n   * @param cause   - The underlying error from AWS SDK.\n   */\n  constructor(message: string, cause?: unknown) {\n    super(message, { cause });\n  }\n}\n\n/**\n * Thrown when {@link SendEmailOptions} are invalid, such as missing both\n * `html` and `text`, or having an invalid email address format.\n *\n * @example\n * ```ts\n * import { sendEmail, SesValidationError } from 'aws-ses-adapter';\n *\n * try {\n *   // Missing both html and text\n *   await sendEmail({ to: 'user@example.com', subject: 'Hi' });\n * } catch (err) {\n *   if (err instanceof SesValidationError) {\n *     console.error('Validation error:', err.message);\n *   }\n * }\n * ```\n */\nexport class SesValidationError extends Error {\n  /** @override */\n  readonly name = 'SesValidationError' as const;\n\n  /**\n   * @param message - Description of the validation failure.\n   */\n  constructor(message: string) {\n    super(message);\n  }\n}\n","/**\n * @module adapter\n * Core SesAdapter class that wraps the AWS SES client and provides\n * simplified email sending methods.\n */\n\nimport type {\n  SendEmailCommandInput,\n  SendRawEmailCommandInput,\n  SESClient,\n} from '@aws-sdk/client-ses';\nimport { SendEmailCommand, SendRawEmailCommand } from '@aws-sdk/client-ses';\nimport { buildSesClient } from './client.js';\nimport { SesConfigError, SesSendError, SesValidationError } from './errors.js';\nimport type {\n  EmailAttachment,\n  ResolvedSesAdapterConfig,\n  SendEmailOptions,\n  SendEmailResult,\n  SendEmailWithAttachmentsOptions,\n  SesAdapterConfig,\n} from './types.js';\n\n/**\n * Resolves the adapter configuration by merging user-provided values with\n * environment variable fallbacks.\n *\n * @param config - Optional user-provided configuration.\n * @returns The resolved configuration with all required fields populated.\n * @throws {SesConfigError} When required fields cannot be resolved from config or env vars.\n *\n * @internal\n */\nfunction resolveConfig(\n  config: SesAdapterConfig = {},\n): ResolvedSesAdapterConfig {\n  const region = config.region ?? process.env['AWS_SES_REGION'];\n  const accessKeyId = config.accessKeyId ?? process.env['AWS_ACCESS_KEY_ID'];\n  const secretAccessKey =\n    config.secretAccessKey ?? process.env['AWS_SECRET_ACCESS_KEY'];\n  const defaultFrom = config.defaultFrom ?? process.env['AWS_SES_FROM_EMAIL'];\n\n  if (!region) {\n    throw new SesConfigError(\n      'AWS SES region is required. Provide it via config.region or the AWS_SES_REGION environment variable.',\n    );\n  }\n  if (!accessKeyId) {\n    throw new SesConfigError(\n      'AWS access key ID is required. Provide it via config.accessKeyId or the AWS_ACCESS_KEY_ID environment variable.',\n    );\n  }\n  if (!secretAccessKey) {\n    throw new SesConfigError(\n      'AWS secret access key is required. Provide it via config.secretAccessKey or the AWS_SECRET_ACCESS_KEY environment variable.',\n    );\n  }\n\n  return { region, accessKeyId, secretAccessKey, defaultFrom };\n}\n\n/**\n * Normalizes a value that can be a single string or an array of strings\n * into a guaranteed array.\n *\n * @param value - A string or array of strings.\n * @returns An array of strings.\n *\n * @internal\n */\nfunction toArray(value: string | string[]): string[] {\n  return Array.isArray(value) ? value : [value];\n}\n\n/**\n * Encodes a MIME header value using RFC 2047 Base64 encoded-word syntax\n * when the value contains non-ASCII characters.\n *\n * @param value - The raw header value (e.g. a subject line).\n * @returns The value as-is if it is pure ASCII, otherwise `=?UTF-8?B?...?=`.\n *\n * @internal\n */\nfunction encodeHeaderValue(value: string): string {\n  // If no non-ASCII characters are present, return as-is\n  if (!/[\\u0080-\\uFFFF]/.test(value)) return value;\n  return `=?UTF-8?B?${Buffer.from(value, 'utf-8').toString('base64')}?=`;\n}\n\n/**\n * Builds a multipart/mixed MIME email message ready to be sent via\n * `SendRawEmailCommand`.\n *\n * The body section uses multipart/alternative when both `html` and `text` are\n * supplied so that email clients can choose the best representation.\n *\n * @internal\n */\nfunction buildMimeMessage(\n  options: SendEmailWithAttachmentsOptions,\n  from: string,\n): string {\n  const mixedBoundary = `----=_Mixed_${Date.now()}_${Math.random().toString(36).slice(2)}`;\n  const altBoundary = `----=_Alt_${Date.now()}_${Math.random().toString(36).slice(2)}`;\n\n  const lines: string[] = [];\n\n  // RFC 2822 headers\n  lines.push(`From: ${from}`);\n  lines.push(`To: ${toArray(options.to).join(', ')}`);\n  if (options.cc) lines.push(`Cc: ${toArray(options.cc).join(', ')}`);\n  if (options.bcc) lines.push(`Bcc: ${toArray(options.bcc).join(', ')}`);\n  if (options.replyTo)\n    lines.push(`Reply-To: ${toArray(options.replyTo).join(', ')}`);\n  lines.push(`Subject: ${encodeHeaderValue(options.subject)}`);\n  lines.push('MIME-Version: 1.0');\n  lines.push(`Content-Type: multipart/mixed; boundary=\"${mixedBoundary}\"`);\n  lines.push('');\n\n  // ── Body part ────────────────────────────────────────────────────────────\n  if (options.html && options.text) {\n    // Both formats: wrap in multipart/alternative\n    lines.push(`--${mixedBoundary}`);\n    lines.push(\n      `Content-Type: multipart/alternative; boundary=\"${altBoundary}\"`,\n    );\n    lines.push('');\n\n    lines.push(`--${altBoundary}`);\n    lines.push('Content-Type: text/plain; charset=UTF-8');\n    lines.push('Content-Transfer-Encoding: 8bit');\n    lines.push('');\n    lines.push(options.text);\n    lines.push('');\n\n    lines.push(`--${altBoundary}`);\n    lines.push('Content-Type: text/html; charset=UTF-8');\n    lines.push('Content-Transfer-Encoding: 8bit');\n    lines.push('');\n    lines.push(options.html);\n    lines.push('');\n\n    lines.push(`--${altBoundary}--`);\n    lines.push('');\n  } else if (options.html) {\n    lines.push(`--${mixedBoundary}`);\n    lines.push('Content-Type: text/html; charset=UTF-8');\n    lines.push('Content-Transfer-Encoding: 8bit');\n    lines.push('');\n    lines.push(options.html);\n    lines.push('');\n  } else if (options.text) {\n    lines.push(`--${mixedBoundary}`);\n    lines.push('Content-Type: text/plain; charset=UTF-8');\n    lines.push('Content-Transfer-Encoding: 8bit');\n    lines.push('');\n    lines.push(options.text);\n    lines.push('');\n  }\n\n  // ── Attachment parts ─────────────────────────────────────────────────────\n  for (const attachment of options.attachments) {\n    const encoded = encodeAttachment(attachment);\n    const safeName = attachment.filename.replace(/\"/g, '');\n\n    lines.push(`--${mixedBoundary}`);\n    lines.push(`Content-Type: ${attachment.contentType}; name=\"${safeName}\"`);\n    lines.push('Content-Transfer-Encoding: base64');\n    lines.push(`Content-Disposition: attachment; filename=\"${safeName}\"`);\n    lines.push('');\n    // RFC 2045: base64 lines must not exceed 76 characters\n    lines.push(encoded.match(/.{1,76}/g)?.join('\\r\\n') ?? encoded);\n    lines.push('');\n  }\n\n  lines.push(`--${mixedBoundary}--`);\n\n  return lines.join('\\r\\n');\n}\n\n/**\n * Encodes an attachment's content as a base64 string.\n *\n * @param attachment - The attachment to encode.\n * @returns Base64-encoded string.\n *\n * @internal\n */\nfunction encodeAttachment(attachment: EmailAttachment): string {\n  if (Buffer.isBuffer(attachment.content)) {\n    return attachment.content.toString('base64');\n  }\n  return Buffer.from(attachment.content).toString('base64');\n}\n\n/**\n * Core adapter class that wraps the AWS SES client and provides a simplified\n * API for sending emails.\n *\n * This class is not meant to be instantiated directly by consumers.\n * Use the singleton functions exported from the main module instead.\n *\n * @see {@link init} to initialize the singleton.\n * @see {@link sendEmail} to send a standard email.\n * @see {@link sendRawEmail} to send a raw MIME email.\n */\nexport class SesAdapter {\n  /** @internal */\n  private readonly sesClient: SESClient;\n\n  /** @internal */\n  private readonly config: ResolvedSesAdapterConfig;\n\n  /**\n   * Creates a new SesAdapter instance.\n   *\n   * @param userConfig - Optional configuration. Missing fields fall back to environment variables.\n   * @throws {SesConfigError} When required configuration fields are missing.\n   */\n  constructor(userConfig: SesAdapterConfig = {}) {\n    this.config = resolveConfig(userConfig);\n    this.sesClient = buildSesClient(this.config);\n  }\n\n  /**\n   * Sends an email using AWS SES.\n   *\n   * At least one of `options.html` or `options.text` must be provided.\n   * If `options.from` is not specified, the `defaultFrom` configured during\n   * initialization is used. If neither is available, the call throws.\n   *\n   * @param options - Email sending options.\n   * @returns A promise resolving to a {@link SendEmailResult}.\n   * @throws {SesValidationError} When required email fields are missing or invalid.\n   * @throws {SesSendError} When the AWS SES API call fails.\n   *\n   * @example\n   * ```ts\n   * const result = await adapter.sendEmail({\n   *   to: ['alice@example.com', 'bob@example.com'],\n   *   subject: 'Hello!',\n   *   html: '<p>Hello World</p>',\n   *   text: 'Hello World',\n   *   cc: 'manager@example.com',\n   * });\n   * ```\n   */\n  async sendEmail(options: SendEmailOptions): Promise<SendEmailResult> {\n    if (!options.html && !options.text) {\n      throw new SesValidationError(\n        'At least one of \"html\" or \"text\" must be provided in SendEmailOptions.',\n      );\n    }\n\n    const from = options.from ?? this.config.defaultFrom;\n    if (!from) {\n      throw new SesValidationError(\n        'A sender address is required. Provide \"from\" in SendEmailOptions or set \"defaultFrom\" during init().',\n      );\n    }\n\n    const toAddresses = toArray(options.to);\n\n    const params: SendEmailCommandInput = {\n      Source: from,\n      Destination: {\n        ToAddresses: toAddresses,\n        CcAddresses: options.cc ? toArray(options.cc) : undefined,\n        BccAddresses: options.bcc ? toArray(options.bcc) : undefined,\n      },\n      Message: {\n        Subject: {\n          Data: options.subject,\n          Charset: 'UTF-8',\n        },\n        Body: {\n          Html: options.html\n            ? { Data: options.html, Charset: 'UTF-8' }\n            : undefined,\n          Text: options.text\n            ? { Data: options.text, Charset: 'UTF-8' }\n            : undefined,\n        },\n      },\n      ReplyToAddresses: options.replyTo ? toArray(options.replyTo) : undefined,\n    };\n\n    try {\n      const command = new SendEmailCommand(params);\n      const response = await this.sesClient.send(command);\n\n      return {\n        success: true,\n        messageId: response.MessageId,\n      };\n    } catch (error) {\n      throw new SesSendError(\n        `Failed to send email to ${toAddresses.join(', ')}: ${error instanceof Error ? error.message : String(error)}`,\n        error,\n      );\n    }\n  }\n\n  /**\n   * Sends a raw MIME email using AWS SES.\n   *\n   * Use this method when you need full control over the email format, such as\n   * sending emails with attachments or custom headers.\n   *\n   * @param rawMessage - The raw MIME email message as a string.\n   * @returns A promise resolving to a {@link SendEmailResult}.\n   * @throws {SesValidationError} When the raw message is empty.\n   * @throws {SesSendError} When the AWS SES API call fails.\n   *\n   * @example\n   * ```ts\n   * const mimeMessage = [\n   *   'From: sender@example.com',\n   *   'To: recipient@example.com',\n   *   'Subject: Test',\n   *   'MIME-Version: 1.0',\n   *   'Content-Type: text/plain',\n   *   '',\n   *   'Hello World',\n   * ].join('\\r\\n');\n   *\n   * const result = await adapter.sendRawEmail(mimeMessage);\n   * ```\n   */\n  async sendRawEmail(rawMessage: string): Promise<SendEmailResult> {\n    if (!rawMessage || rawMessage.trim().length === 0) {\n      throw new SesValidationError('rawMessage cannot be empty.');\n    }\n\n    const params: SendRawEmailCommandInput = {\n      RawMessage: {\n        Data: Buffer.from(rawMessage),\n      },\n    };\n\n    try {\n      const command = new SendRawEmailCommand(params);\n      const response = await this.sesClient.send(command);\n\n      return {\n        success: true,\n        messageId: response.MessageId,\n      };\n    } catch (error) {\n      throw new SesSendError(\n        `Failed to send raw email: ${error instanceof Error ? error.message : String(error)}`,\n        error,\n      );\n    }\n  }\n\n  /**\n   * Sends an email with one or more file attachments using AWS SES.\n   *\n   * Internally builds a multipart/mixed MIME message and dispatches it via\n   * `SendRawEmailCommand`, giving you full attachment support without needing\n   * to craft raw MIME by hand.\n   *\n   * At least one of `options.html` or `options.text` must be provided.\n   * The `options.attachments` array must contain at least one item.\n   *\n   * @param options - Email options including the attachments array.\n   * @returns A promise resolving to a {@link SendEmailResult}.\n   * @throws {SesValidationError} When required fields are missing or invalid.\n   * @throws {SesSendError} When the AWS SES API call fails.\n   *\n   * @example\n   * ```ts\n   * const result = await adapter.sendEmailWithAttachments({\n   *   to: 'alice@example.com',\n   *   subject: 'Your invoice',\n   *   html: '<p>Please find the invoice attached.</p>',\n   *   attachments: [\n   *     {\n   *       filename: 'invoice.pdf',\n   *       content: fs.readFileSync('./invoice.pdf'),\n   *       contentType: 'application/pdf',\n   *     },\n   *   ],\n   * });\n   * ```\n   */\n  async sendEmailWithAttachments(\n    options: SendEmailWithAttachmentsOptions,\n  ): Promise<SendEmailResult> {\n    if (!options.html && !options.text) {\n      throw new SesValidationError(\n        'At least one of \"html\" or \"text\" must be provided in SendEmailWithAttachmentsOptions.',\n      );\n    }\n\n    if (!options.attachments || options.attachments.length === 0) {\n      throw new SesValidationError(\n        'At least one attachment must be provided in SendEmailWithAttachmentsOptions.attachments.',\n      );\n    }\n\n    const from = options.from ?? this.config.defaultFrom;\n    if (!from) {\n      throw new SesValidationError(\n        'A sender address is required. Provide \"from\" in SendEmailWithAttachmentsOptions or set \"defaultFrom\" during init().',\n      );\n    }\n\n    const rawMessage = buildMimeMessage(options, from);\n    const toAddresses = toArray(options.to);\n\n    const params: SendRawEmailCommandInput = {\n      RawMessage: {\n        Data: Buffer.from(rawMessage),\n      },\n    };\n\n    try {\n      const command = new SendRawEmailCommand(params);\n      const response = await this.sesClient.send(command);\n\n      return {\n        success: true,\n        messageId: response.MessageId,\n      };\n    } catch (error) {\n      throw new SesSendError(\n        `Failed to send email with attachments to ${toAddresses.join(', ')}: ${error instanceof Error ? error.message : String(error)}`,\n        error,\n      );\n    }\n  }\n\n  /**\n   * Returns whether the adapter has a default \"From\" address configured.\n   *\n   * @returns `true` if a default from address is available.\n   *\n   * @example\n   * ```ts\n   * if (adapter.hasDefaultFrom()) {\n   *   console.log('Default from:', adapter.getDefaultFrom());\n   * }\n   * ```\n   */\n  hasDefaultFrom(): boolean {\n    return !!this.config.defaultFrom;\n  }\n\n  /**\n   * Returns the default \"From\" email address, or `undefined` if not set.\n   *\n   * @returns The default sender address, or `undefined`.\n   *\n   * @example\n   * ```ts\n   * const from = adapter.getDefaultFrom();\n   * // => 'noreply@example.com' or undefined\n   * ```\n   */\n  getDefaultFrom(): string | undefined {\n    return this.config.defaultFrom;\n  }\n\n  /**\n   * Returns the AWS region the adapter is configured to use.\n   *\n   * @returns The AWS region string.\n   *\n   * @example\n   * ```ts\n   * console.log(adapter.getRegion()); // => 'us-east-1'\n   * ```\n   */\n  getRegion(): string {\n    return this.config.region;\n  }\n}\n","/**\n * @module aws-ses-adapter\n *\n * A lightweight adapter that simplifies the AWS SES email sending API for Node.js.\n *\n * ## Quick Start\n *\n * **1. Initialize once** (at application startup):\n * ```ts\n * import { init } from 'aws-ses-adapter';\n *\n * init({\n *   region: 'us-east-1',\n *   accessKeyId: 'YOUR_KEY',\n *   secretAccessKey: 'YOUR_SECRET',\n *   defaultFrom: 'noreply@example.com',\n * });\n * ```\n *\n * **2. Use anywhere** in your application:\n * ```ts\n * import { sendEmail } from 'aws-ses-adapter';\n *\n * await sendEmail({\n *   to: 'user@example.com',\n *   subject: 'Welcome!',\n *   html: '<h1>Welcome</h1>',\n * });\n * ```\n *\n * ## Environment Variables\n *\n * If credentials are not passed to `init()`, the adapter reads:\n * - `AWS_SES_REGION`\n * - `AWS_ACCESS_KEY_ID`\n * - `AWS_SECRET_ACCESS_KEY`\n * - `AWS_SES_FROM_EMAIL` (optional default sender)\n */\n\nimport { SesAdapter } from './adapter.js';\nimport { SesNotInitializedError } from './errors.js';\nimport type {\n  SendEmailOptions,\n  SendEmailResult,\n  SendEmailWithAttachmentsOptions,\n  SesAdapterConfig,\n} from './types.js';\n\n// ─── Singleton state ──────────────────────────────────────────────────────────\n\n/** @internal */\nlet _instance: SesAdapter | null = null;\n\n/**\n * Returns the current singleton instance.\n * @throws {SesNotInitializedError} If `init()` has not been called yet.\n * @internal\n */\nfunction getInstance(): SesAdapter {\n  if (!_instance) {\n    throw new SesNotInitializedError();\n  }\n  return _instance;\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Initializes the SES Adapter singleton.\n *\n * Must be called **once** before any other function in this module.\n * Calling `init()` again will replace the existing singleton instance,\n * which is useful for reconfiguration during testing.\n *\n * Credentials are resolved in the following order:\n * 1. Values provided in the `config` argument.\n * 2. Environment variables (`AWS_SES_REGION`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`).\n *\n * @param config - Optional configuration. Omit any field to fall back to environment variables.\n * @throws {SesConfigError} When required credentials cannot be resolved.\n *\n * @example\n * ```ts\n * // Using explicit credentials\n * init({\n *   region: 'us-east-1',\n *   accessKeyId: process.env.MY_KEY_ID,\n *   secretAccessKey: process.env.MY_SECRET,\n *   defaultFrom: 'no-reply@myapp.com',\n * });\n *\n * // Relying entirely on environment variables\n * init();\n * ```\n */\nexport function init(config: SesAdapterConfig = {}): void {\n  _instance = new SesAdapter(config);\n}\n\n/**\n * Sends an email using the initialized SES Adapter.\n *\n * At least one of `options.html` or `options.text` must be provided.\n * If `options.from` is not specified, the `defaultFrom` set during {@link init} is used.\n *\n * @param options - Email sending options.\n * @returns A promise resolving to a {@link SendEmailResult}.\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n * @throws {SesValidationError} When required email fields are missing or invalid.\n * @throws {SesSendError} When the AWS SES API call fails.\n *\n * @example\n * ```ts\n * import { sendEmail } from 'aws-ses-adapter';\n *\n * const result = await sendEmail({\n *   to: 'alice@example.com',\n *   subject: 'Hello Alice',\n *   html: '<p>Hi Alice!</p>',\n *   text: 'Hi Alice!',\n *   cc: 'manager@example.com',\n *   bcc: ['audit@example.com'],\n *   replyTo: 'support@example.com',\n * });\n *\n * console.log(result.messageId);\n * ```\n */\nexport async function sendEmail(\n  options: SendEmailOptions,\n): Promise<SendEmailResult> {\n  return getInstance().sendEmail(options);\n}\n\n/**\n * Sends an email with one or more file attachments using the initialized SES Adapter.\n *\n * Internally builds a multipart/mixed MIME message, so you don't need to\n * construct raw MIME yourself. At least one of `options.html` or `options.text`\n * must be provided, and `options.attachments` must contain at least one item.\n *\n * @param options - Email options including the attachments array.\n * @returns A promise resolving to a {@link SendEmailResult}.\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n * @throws {SesValidationError} When required fields are missing or invalid.\n * @throws {SesSendError} When the AWS SES API call fails.\n *\n * @example\n * ```ts\n * import { sendEmailWithAttachments } from 'aws-ses-adapter';\n * import { readFileSync } from 'fs';\n *\n * const result = await sendEmailWithAttachments({\n *   to: 'alice@example.com',\n *   subject: 'Your invoice',\n *   html: '<p>Please find the invoice attached.</p>',\n *   attachments: [\n *     {\n *       filename: 'invoice.pdf',\n *       content: readFileSync('./invoice.pdf'),\n *       contentType: 'application/pdf',\n *     },\n *   ],\n * });\n *\n * console.log(result.messageId);\n * ```\n */\nexport async function sendEmailWithAttachments(\n  options: SendEmailWithAttachmentsOptions,\n): Promise<SendEmailResult> {\n  return getInstance().sendEmailWithAttachments(options);\n}\n\n/**\n * Sends a raw MIME email using the initialized SES Adapter.\n *\n * Use this when you need full control over the email, such as including\n * attachments or custom MIME headers.\n *\n * @param rawMessage - The raw MIME email message as a string.\n * @returns A promise resolving to a {@link SendEmailResult}.\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n * @throws {SesValidationError} When the raw message is empty.\n * @throws {SesSendError} When the AWS SES API call fails.\n *\n * @example\n * ```ts\n * import { sendRawEmail } from 'aws-ses-adapter';\n *\n * const mime = [\n *   'From: sender@example.com',\n *   'To: recipient@example.com',\n *   'Subject: File attached',\n *   'MIME-Version: 1.0',\n *   'Content-Type: text/plain',\n *   '',\n *   'Please find the attachment.',\n * ].join('\\r\\n');\n *\n * const result = await sendRawEmail(mime);\n * ```\n */\nexport async function sendRawEmail(\n  rawMessage: string,\n): Promise<SendEmailResult> {\n  return getInstance().sendRawEmail(rawMessage);\n}\n\n/**\n * Returns whether the singleton has been initialized via {@link init}.\n *\n * @returns `true` if `init()` has been called successfully.\n *\n * @example\n * ```ts\n * import { isInitialized } from 'aws-ses-adapter';\n *\n * if (!isInitialized()) {\n *   init();\n * }\n * ```\n */\nexport function isInitialized(): boolean {\n  return _instance !== null;\n}\n\n/**\n * Returns whether a default \"From\" address is configured in the singleton.\n *\n * @returns `true` if a default sender address is set.\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n *\n * @example\n * ```ts\n * import { hasDefaultFrom } from 'aws-ses-adapter';\n *\n * console.log(hasDefaultFrom()); // => true\n * ```\n */\nexport function hasDefaultFrom(): boolean {\n  return getInstance().hasDefaultFrom();\n}\n\n/**\n * Returns the default \"From\" email address configured in the singleton,\n * or `undefined` if none was set.\n *\n * @returns The default sender address, or `undefined`.\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n *\n * @example\n * ```ts\n * import { getDefaultFrom } from 'aws-ses-adapter';\n *\n * const from = getDefaultFrom();\n * // => 'noreply@example.com' or undefined\n * ```\n */\nexport function getDefaultFrom(): string | undefined {\n  return getInstance().getDefaultFrom();\n}\n\n/**\n * Returns the AWS region the singleton is configured to use.\n *\n * @returns The AWS region string (e.g. `'us-east-1'`).\n * @throws {SesNotInitializedError} If {@link init} has not been called.\n *\n * @example\n * ```ts\n * import { getRegion } from 'aws-ses-adapter';\n *\n * console.log(getRegion()); // => 'us-east-1'\n * ```\n */\nexport function getRegion(): string {\n  return getInstance().getRegion();\n}\n\n// ─── Re-exports ───────────────────────────────────────────────────────────────\n\n/**\n * Re-export the core adapter class for advanced use cases such as\n * creating multiple independent instances or building framework integrations\n * (e.g., a NestJS module).\n */\nexport { SesAdapter } from './adapter.js';\n\n/** Re-export all custom error classes for consumer-side `instanceof` checks. */\nexport {\n  SesConfigError,\n  SesNotInitializedError,\n  SesSendError,\n  SesValidationError,\n} from './errors.js';\n\n/** Re-export all public types and interfaces. */\nexport type {\n  EmailAttachment,\n  SendEmailOptions,\n  SendEmailResult,\n  SendEmailWithAttachmentsOptions,\n  SesAdapterConfig,\n} from './types.js';\n"]}