@igniter-js/mail 0.1.0 → 0.1.1

package/dist/adapters/index.mjs

@@ -0,0 +1,361 @@
+import { IgniterError } from '@igniter-js/core';
+import { Resend } from 'resend';
+import nodemailer from 'nodemailer';
+
+// src/errors/mail.error.ts
+var IgniterMailError = class _IgniterMailError extends IgniterError {
+  constructor(payload) {
+    super({
+      code: payload.code,
+      message: payload.message,
+      statusCode: payload.statusCode,
+      causer: "@igniter-js/mail",
+      details: payload.details,
+      metadata: payload.metadata,
+      logger: payload.logger
+    });
+    this.name = "IgniterMailError";
+  }
+  /**
+   * Type guard utility.
+   */
+  static is(error) {
+    return error instanceof _IgniterMailError;
+  }
+};
+
+// src/adapters/postmark.adapter.ts
+var PostmarkMailAdapter = class _PostmarkMailAdapter {
+  /**
+   * Creates a new adapter instance.
+   *
+   * @param credentials - Provider credentials (secret/from).
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   */
+  constructor(credentials = {}) {
+    this.credentials = credentials;
+  }
+  /**
+   * Creates a new adapter instance.
+   *
+   * @param credentials - Provider credentials (secret/from).
+   * @returns A Postmark adapter instance.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   * @example
+   * ```ts
+   * const adapter = PostmarkMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })
+   * ```
+   */
+  static create(credentials) {
+    return new _PostmarkMailAdapter(credentials);
+  }
+  /**
+   * Sends an email using Postmark (HTTP API).
+   *
+   * @param params - Normalized email parameters.
+   * @returns A promise that resolves when the email is accepted.
+   * @throws {IgniterMailError} When configuration is invalid or Postmark rejects the request.
+   * @example
+   * ```ts
+   * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })
+   * ```
+   */
+  async send(params) {
+    if (!this.credentials.secret) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "Postmark adapter secret is required"
+      });
+    }
+    if (!this.credentials.from) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "Postmark adapter from is required"
+      });
+    }
+    const token = this.credentials.secret;
+    const from = this.credentials.from;
+    const response = await fetch("https://api.postmarkapp.com/email", {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        "X-Postmark-Server-Token": token
+      },
+      body: JSON.stringify({
+        From: from,
+        To: params.to,
+        Subject: params.subject,
+        HtmlBody: params.html,
+        TextBody: params.text
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      throw new IgniterMailError({
+        code: "MAIL_PROVIDER_SEND_FAILED",
+        message: "Postmark send failed",
+        metadata: {
+          status: response.status,
+          body
+        }
+      });
+    }
+  }
+};
+var ResendMailAdapter = class _ResendMailAdapter {
+  /**
+   * Creates an adapter with credentials.
+   *
+   * @param credentials - Adapter credentials including API secret and default from.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   */
+  constructor(credentials = {}) {
+    this.credentials = credentials;
+  }
+  /**
+   * Creates a new adapter instance.
+   *
+   * @param credentials - Adapter credentials including API secret and default from.
+   * @returns A configured Resend adapter.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   * @example
+   * ```ts
+   * const adapter = ResendMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })
+   * ```
+   */
+  static create(credentials) {
+    return new _ResendMailAdapter(credentials);
+  }
+  /**
+   * Sends an email using Resend.
+   *
+   * @param params - Email payload to send.
+   * @returns Resolves when the email is accepted by Resend.
+   * @throws {IgniterMailError} When credentials are missing or Resend rejects the request.
+   *
+   * @example
+   * ```ts
+   * await adapter.send({ to: 'user@example.com', subject: 'Welcome', html: '<p>Hi</p>', text: 'Hi' })
+   * ```
+   */
+  async send(params) {
+    if (!this.credentials.secret) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "Resend adapter secret is required"
+      });
+    }
+    if (!this.credentials.from) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "Resend adapter from is required"
+      });
+    }
+    const resend = new Resend(this.credentials.secret);
+    const from = this.credentials.from;
+    await resend.emails.create({
+      to: params.to,
+      from,
+      subject: params.subject,
+      html: params.html,
+      text: params.text,
+      scheduledAt: params.scheduledAt?.toISOString()
+    });
+  }
+};
+
+// src/adapters/sendgrid.adapter.ts
+var SendGridMailAdapter = class _SendGridMailAdapter {
+  /**
+   * Creates an adapter with credentials.
+   *
+   * @param credentials - Adapter credentials including API secret and default from.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   */
+  constructor(credentials = {}) {
+    this.credentials = credentials;
+  }
+  /**
+   * Creates a new adapter instance.
+   *
+   * @param credentials - Adapter credentials including API secret and default from.
+   * @returns A configured SendGrid adapter.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   * @example
+   * ```ts
+   * const adapter = SendGridMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })
+   * ```
+   */
+  static create(credentials) {
+    return new _SendGridMailAdapter(credentials);
+  }
+  /**
+   * Sends an email using SendGrid (HTTP API).
+   *
+   * @param params - Email payload to send.
+   * @returns Resolves when the email is accepted by SendGrid.
+   * @throws {IgniterMailError} When credentials are missing or the API fails.
+   *
+   * @example
+   * ```ts
+   * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+   * ```
+   */
+  async send(params) {
+    if (!this.credentials.secret) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "SendGrid adapter secret is required"
+      });
+    }
+    if (!this.credentials.from) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "SendGrid adapter from is required"
+      });
+    }
+    const apiKey = this.credentials.secret;
+    const from = this.credentials.from;
+    const response = await fetch("https://api.sendgrid.com/v3/mail/send", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        personalizations: [
+          {
+            to: [{ email: params.to }]
+          }
+        ],
+        from: { email: from },
+        subject: params.subject,
+        content: [
+          { type: "text/plain", value: params.text },
+          { type: "text/html", value: params.html }
+        ]
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      throw new IgniterMailError({
+        code: "MAIL_PROVIDER_SEND_FAILED",
+        message: "SendGrid send failed",
+        metadata: {
+          status: response.status,
+          body
+        }
+      });
+    }
+  }
+};
+var SmtpMailAdapter = class _SmtpMailAdapter {
+  /**
+   * Creates an adapter with credentials.
+   *
+   * @param credentials - Adapter credentials including SMTP URL and default from.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   */
+  constructor(credentials = {}) {
+    this.credentials = credentials;
+  }
+  /**
+   * Creates a new adapter instance.
+   *
+   * @param credentials - Adapter credentials including SMTP URL and default from.
+   * @returns A configured SMTP adapter.
+   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.
+   * @example
+   * ```ts
+   * const adapter = SmtpMailAdapter.create({ secret: 'smtps://user:pass@host:465', from: 'no-reply@acme.com' })
+   * ```
+   */
+  static create(credentials) {
+    return new _SmtpMailAdapter(credentials);
+  }
+  /**
+   * Sends an email using Nodemailer over SMTP.
+   *
+   * @param params - Email payload to send.
+   * @returns Resolves when the email is sent.
+   * @throws {IgniterMailError} When credentials are missing or the SMTP send fails.
+   *
+   * @example
+   * ```ts
+   * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+   * ```
+   */
+  async send(params) {
+    if (!this.credentials.secret) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "SMTP adapter secret is required"
+      });
+    }
+    if (!this.credentials.from) {
+      throw new IgniterMailError({
+        code: "MAIL_ADAPTER_CONFIGURATION_INVALID",
+        message: "SMTP adapter from is required"
+      });
+    }
+    const smtpUrl = this.credentials.secret;
+    const from = this.credentials.from;
+    const transport = nodemailer.createTransport(smtpUrl, {
+      connectionTimeout: 1e4,
+      greetingTimeout: 5e3,
+      socketTimeout: 1e4,
+      tls: {
+        rejectUnauthorized: false
+      }
+    });
+    try {
+      await transport.sendMail({
+        from,
+        to: params.to,
+        subject: params.subject,
+        html: params.html,
+        text: params.text
+      });
+    } catch (error) {
+      throw new IgniterMailError({
+        code: "MAIL_PROVIDER_SEND_FAILED",
+        message: "SMTP send failed",
+        metadata: {
+          originalError: error
+        }
+      });
+    } finally {
+      transport.close();
+    }
+  }
+};
+
+// src/adapters/mock.adapter.ts
+var MockMailAdapter = class _MockMailAdapter {
+  constructor() {
+    /** Tracks all send calls. */
+    this.sent = [];
+    /** Tracks method call counts. */
+    this.calls = {
+      send: 0
+    };
+  }
+  /** Creates a new mock adapter instance. */
+  static create() {
+    return new _MockMailAdapter();
+  }
+  async send(params) {
+    this.calls.send += 1;
+    this.sent.push(params);
+  }
+  /** Clears all tracked state. */
+  clear() {
+    this.sent.length = 0;
+    this.calls.send = 0;
+  }
+};
+
+export { MockMailAdapter, PostmarkMailAdapter, ResendMailAdapter, SendGridMailAdapter, SmtpMailAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/adapters/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/mail.error.ts","../../src/adapters/postmark.adapter.ts","../../src/adapters/resend.adapter.ts","../../src/adapters/sendgrid.adapter.ts","../../src/adapters/smtp.adapter.ts","../../src/adapters/mock.adapter.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { IgniterError, type IgniterLogger } from '@igniter-js/core'\n\n/**\n * Known error codes thrown by `@igniter-js/mail` runtime.\n */\nexport type IgniterMailErrorCode =\n  | 'MAIL_PROVIDER_FROM_REQUIRED'\n  | 'MAIL_PROVIDER_ADAPTER_REQUIRED'\n  | 'MAIL_PROVIDER_ADAPTER_SECRET_REQUIRED'\n  | 'MAIL_PROVIDER_ADAPTER_NOT_FOUND'\n  | 'MAIL_PROVIDER_TEMPLATES_REQUIRED'\n  | 'MAIL_PROVIDER_TEMPLATE_NOT_FOUND'\n  | 'MAIL_PROVIDER_TEMPLATE_DATA_INVALID'\n  | 'MAIL_PROVIDER_SCHEDULE_DATE_INVALID'\n  | 'MAIL_PROVIDER_SEND_FAILED'\n  | 'MAIL_PROVIDER_SCHEDULE_FAILED'\n  | 'MAIL_ADAPTER_CONFIGURATION_INVALID'\n  | 'MAIL_TEMPLATE_CONFIGURATION_INVALID'\n  | 'MAIL_PROVIDER_SCHEDULE_QUEUE_NOT_CONFIGURED'\n\n/**\n * Payload used to create an {@link IgniterMailError}.\n */\nexport type IgniterMailErrorPayload = {\n  /** Machine-readable error code. */\n  code: IgniterMailErrorCode\n  /** Human-readable message. */\n  message: string\n  /** Optional HTTP status code when surfacing errors through HTTP boundaries. */\n  statusCode?: number\n  /** Optional original cause. */\n  cause?: unknown\n  /** Extra diagnostic details (e.g. schema issues). */\n  details?: unknown\n  /** Arbitrary metadata for debugging. */\n  metadata?: Record<string, unknown>\n  /** Optional logger used by IgniterError. */\n  logger?: IgniterLogger\n}\n\n/**\n * Typed error used by the `IgniterMail` runtime.\n *\n * This is designed to be stable for extraction into `@igniter-js/mail`.\n */\nexport class IgniterMailError extends IgniterError {\n  declare readonly code: IgniterMailErrorCode\n\n  constructor(payload: IgniterMailErrorPayload) {\n    super({\n      code: payload.code,\n      message: payload.message,\n      statusCode: payload.statusCode,\n      causer: '@igniter-js/mail',\n      details: payload.details,\n      metadata: payload.metadata,\n      logger: payload.logger,\n    })\n\n    this.name = 'IgniterMailError'\n  }\n\n  /**\n   * Type guard utility.\n   */\n  static is(error: unknown): error is IgniterMailError {\n    return error instanceof IgniterMailError\n  }\n}\n\n","import { IgniterMailError } from '../errors/mail.error'\nimport type {\n  IgniterMailAdapter,\n  IgniterMailAdapterCredentials,\n  IgniterMailAdapterSendParams,\n} from '../types/adapter'\n\n/**\n * Postmark adapter.\n *\n * Notes:\n * - This implementation uses `fetch` (no SDK dependency).\n * - Designed to be extracted to `@igniter-js/mail/adapters/postmark`.\n *\n * @example\n * ```ts\n * const adapter = PostmarkMailAdapter.create({\n *   secret: process.env.POSTMARK_SERVER_TOKEN,\n *   from: 'no-reply@example.com',\n * })\n * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })\n * ```\n */\nexport class PostmarkMailAdapter implements IgniterMailAdapter {\n  /**\n   * Creates a new adapter instance.\n   *\n   * @param credentials - Provider credentials (secret/from).\n   * @returns A Postmark adapter instance.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   * @example\n   * ```ts\n   * const adapter = PostmarkMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })\n   * ```\n   */\n  static create(credentials: IgniterMailAdapterCredentials) {\n    return new PostmarkMailAdapter(credentials)\n  }\n\n  /**\n   * Creates a new adapter instance.\n   *\n   * @param credentials - Provider credentials (secret/from).\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   */\n  constructor(private readonly credentials: IgniterMailAdapterCredentials = {}) {}\n\n  /**\n   * Sends an email using Postmark (HTTP API).\n   *\n   * @param params - Normalized email parameters.\n   * @returns A promise that resolves when the email is accepted.\n   * @throws {IgniterMailError} When configuration is invalid or Postmark rejects the request.\n   * @example\n   * ```ts\n   * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })\n   * ```\n   */\n  async send(params: IgniterMailAdapterSendParams) {\n    if (!this.credentials.secret) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'Postmark adapter secret is required',\n      })\n    }\n\n    if (!this.credentials.from) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'Postmark adapter from is required',\n      })\n    }\n\n    const token = this.credentials.secret\n    const from = this.credentials.from\n\n    const response = await fetch('https://api.postmarkapp.com/email', {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        'X-Postmark-Server-Token': token,\n      },\n      body: JSON.stringify({\n        From: from,\n        To: params.to,\n        Subject: params.subject,\n        HtmlBody: params.html,\n        TextBody: params.text,\n      }),\n    })\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '')\n\n      throw new IgniterMailError({\n        code: 'MAIL_PROVIDER_SEND_FAILED',\n        message: 'Postmark send failed',\n        metadata: {\n          status: response.status,\n          body,\n        },\n      })\n    }\n  }\n}","import { Resend } from 'resend'\n\nimport { IgniterMailError } from '../errors/mail.error'\nimport type {\n  IgniterMailAdapter,\n  IgniterMailAdapterCredentials,\n  IgniterMailAdapterSendParams,\n} from '../types/adapter'\n\n/**\n * Resend adapter implementation.\n *\n * Notes:\n * - Uses the Resend SDK.\n * - Designed to be extracted to `@igniter-js/mail/adapters/resend`.\n *\n * @example\n * ```ts\n * const adapter = ResendMailAdapter.create({\n *   secret: process.env.RESEND_API_KEY,\n *   from: 'no-reply@example.com',\n * })\n * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })\n * ```\n */\nexport class ResendMailAdapter implements IgniterMailAdapter {\n  /**\n   * Creates a new adapter instance.\n   *\n   * @param credentials - Adapter credentials including API secret and default from.\n   * @returns A configured Resend adapter.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   * @example\n   * ```ts\n   * const adapter = ResendMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })\n   * ```\n   */\n  static create(credentials: IgniterMailAdapterCredentials) {\n    return new ResendMailAdapter(credentials)\n  }\n\n  /**\n   * Creates an adapter with credentials.\n   *\n   * @param credentials - Adapter credentials including API secret and default from.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   */\n  constructor(private readonly credentials: IgniterMailAdapterCredentials = {}) {}\n\n  /**\n   * Sends an email using Resend.\n   *\n   * @param params - Email payload to send.\n   * @returns Resolves when the email is accepted by Resend.\n   * @throws {IgniterMailError} When credentials are missing or Resend rejects the request.\n   *\n   * @example\n   * ```ts\n   * await adapter.send({ to: 'user@example.com', subject: 'Welcome', html: '<p>Hi</p>', text: 'Hi' })\n   * ```\n   */\n  async send(params: IgniterMailAdapterSendParams): Promise<void> {\n    if (!this.credentials.secret) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'Resend adapter secret is required',\n      })\n    }\n\n    if (!this.credentials.from) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'Resend adapter from is required',\n      })\n    }\n\n    const resend = new Resend(this.credentials.secret)\n    const from = this.credentials.from\n\n    await resend.emails.create({\n      to: params.to,\n      from,\n      subject: params.subject,\n      html: params.html,\n      text: params.text,\n      scheduledAt: params.scheduledAt?.toISOString(),\n    })\n  }\n}\n","import { IgniterMailError } from '../errors/mail.error'\nimport type {\n  IgniterMailAdapter,\n  IgniterMailAdapterCredentials,\n  IgniterMailAdapterSendParams,\n} from '../types/adapter'\n\n/**\n * SendGrid adapter implementation.\n *\n * Notes:\n * - This implementation uses `fetch` (no SDK dependency).\n * - Designed to be extracted to `@igniter-js/mail/adapters/sendgrid`.\n *\n * @example\n * ```ts\n * const adapter = SendGridMailAdapter.create({\n *   secret: process.env.SENDGRID_API_KEY,\n *   from: 'no-reply@example.com',\n * })\n * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })\n * ```\n */\nexport class SendGridMailAdapter implements IgniterMailAdapter {\n  /**\n   * Creates a new adapter instance.\n   *\n   * @param credentials - Adapter credentials including API secret and default from.\n   * @returns A configured SendGrid adapter.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   * @example\n   * ```ts\n   * const adapter = SendGridMailAdapter.create({ secret: 'token', from: 'no-reply@acme.com' })\n   * ```\n   */\n  static create(credentials: IgniterMailAdapterCredentials) {\n    return new SendGridMailAdapter(credentials)\n  }\n\n  /**\n   * Creates an adapter with credentials.\n   *\n   * @param credentials - Adapter credentials including API secret and default from.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   */\n  constructor(private readonly credentials: IgniterMailAdapterCredentials = {}) {}\n\n  /**\n   * Sends an email using SendGrid (HTTP API).\n   *\n   * @param params - Email payload to send.\n   * @returns Resolves when the email is accepted by SendGrid.\n   * @throws {IgniterMailError} When credentials are missing or the API fails.\n   *\n   * @example\n   * ```ts\n   * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })\n   * ```\n   */\n  async send(params: IgniterMailAdapterSendParams): Promise<void> {\n    if (!this.credentials.secret) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'SendGrid adapter secret is required',\n      })\n    }\n\n    if (!this.credentials.from) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'SendGrid adapter from is required',\n      })\n    }\n\n    const apiKey = this.credentials.secret\n    const from = this.credentials.from\n\n    const response = await fetch('https://api.sendgrid.com/v3/mail/send', {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        personalizations: [\n          {\n            to: [{ email: params.to }],\n          },\n        ],\n        from: { email: from },\n        subject: params.subject,\n        content: [\n          { type: 'text/plain', value: params.text },\n          { type: 'text/html', value: params.html },\n        ],\n      }),\n    })\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => '')\n\n      throw new IgniterMailError({\n        code: 'MAIL_PROVIDER_SEND_FAILED',\n        message: 'SendGrid send failed',\n        metadata: {\n          status: response.status,\n          body,\n        },\n      })\n    }\n  }\n}\n","import nodemailer from 'nodemailer'\n\nimport { IgniterMailError } from '../errors/mail.error'\nimport type {\n  IgniterMailAdapter,\n  IgniterMailAdapterCredentials,\n  IgniterMailAdapterSendParams,\n} from '../types/adapter'\n\n/**\n * SMTP adapter implementation.\n *\n * Notes:\n * - Uses Nodemailer.\n * - `credentials.secret` must be an SMTP connection URL.\n *\n * @example\n * ```ts\n * const adapter = SmtpMailAdapter.create({\n *   secret: 'smtps://user:pass@host:465',\n *   from: 'no-reply@example.com',\n * })\n * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })\n * ```\n */\nexport class SmtpMailAdapter implements IgniterMailAdapter {\n  /**\n   * Creates a new adapter instance.\n   *\n   * @param credentials - Adapter credentials including SMTP URL and default from.\n   * @returns A configured SMTP adapter.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   * @example\n   * ```ts\n   * const adapter = SmtpMailAdapter.create({ secret: 'smtps://user:pass@host:465', from: 'no-reply@acme.com' })\n   * ```\n   */\n  static create(credentials: IgniterMailAdapterCredentials) {\n    return new SmtpMailAdapter(credentials)\n  }\n\n  /**\n   * Creates an adapter with credentials.\n   *\n   * @param credentials - Adapter credentials including SMTP URL and default from.\n   * @throws {IgniterMailError} Does not throw on creation; errors surface on send.\n   */\n  constructor(private readonly credentials: IgniterMailAdapterCredentials = {}) {}\n\n  /**\n   * Sends an email using Nodemailer over SMTP.\n   *\n   * @param params - Email payload to send.\n   * @returns Resolves when the email is sent.\n   * @throws {IgniterMailError} When credentials are missing or the SMTP send fails.\n   *\n   * @example\n   * ```ts\n   * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })\n   * ```\n   */\n  async send(params: IgniterMailAdapterSendParams): Promise<void> {\n    if (!this.credentials.secret) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'SMTP adapter secret is required',\n      })\n    }\n\n    if (!this.credentials.from) {\n      throw new IgniterMailError({\n        code: 'MAIL_ADAPTER_CONFIGURATION_INVALID',\n        message: 'SMTP adapter from is required',\n      })\n    }\n\n    const smtpUrl = this.credentials.secret\n    const from = this.credentials.from\n\n    const transport = nodemailer.createTransport(smtpUrl, {\n      connectionTimeout: 10000,\n      greetingTimeout: 5000,\n      socketTimeout: 10000,\n      tls: {\n        rejectUnauthorized: false,\n      },\n    })\n\n    try {\n      await transport.sendMail({\n        from,\n        to: params.to,\n        subject: params.subject,\n        html: params.html,\n        text: params.text,\n      })\n    } catch(error) {\n      throw new IgniterMailError({\n        code: 'MAIL_PROVIDER_SEND_FAILED',\n        message: 'SMTP send failed',\n        metadata: {\n          originalError: error,\n        },\n      })\n    } finally {\n      transport.close()\n    }\n  }\n}\n","import type {\n  IgniterMailAdapter,\n  IgniterMailAdapterSendParams,\n} from '../types/adapter'\n\n/**\n * In-memory mock adapter for `@igniter-js/mail`.\n *\n * Use this in tests to avoid real provider calls.\n */\nexport class MockMailAdapter implements IgniterMailAdapter {\n  /** Creates a new mock adapter instance. */\n  static create(): MockMailAdapter {\n    return new MockMailAdapter()\n  }\n\n  /** Tracks all send calls. */\n  public readonly sent: IgniterMailAdapterSendParams[] = []\n\n  /** Tracks method call counts. */\n  public readonly calls = {\n    send: 0,\n  }\n\n  async send(params: IgniterMailAdapterSendParams): Promise<void> {\n    this.calls.send += 1\n    this.sent.push(params)\n  }\n\n  /** Clears all tracked state. */\n  clear(): void {\n    this.sent.length = 0\n    this.calls.send = 0\n  }\n}\n"]}