@igniter-js/mail 0.1.11 → 0.1.13

package/dist/index-CbiH0sth.d.mts

@@ -0,0 +1,286 @@
+/**
+ * Parameters used by a mail adapter to send an email.
+ *
+ * @example
+ * ```ts
+ * await adapter.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome',
+ *   html: '<p>Hello</p>',
+ *   text: 'Hello',
+ * })
+ * ```
+ */
+interface IgniterMailAdapterSendParams {
+    /** Recipient email address. */
+    to: string;
+    /** Email subject. */
+    subject: string;
+    /** HTML body. */
+    html: string;
+    /** Plain-text body. */
+    text: string;
+    /** Optional provider-level scheduled send date. */
+    scheduledAt?: Date;
+}
+/**
+ * Credentials required by mail adapters.
+ *
+ * @example
+ * ```ts
+ * const credentials = { secret: process.env.RESEND_API_KEY, from: 'no-reply@acme.com' }
+ * ```
+ */
+interface IgniterMailAdapterCredentials {
+    /** Provider secret, token, or connection URL. */
+    secret?: string;
+    /** Default FROM address used by the provider. */
+    from?: string;
+}
+/**
+ * Adapter interface used by {@link IgniterMail}.
+ *
+ * Adapters will eventually be imported from `@igniter-js/mail/adapters`.
+ */
+interface IgniterMailAdapter {
+    /**
+     * Sends an email using the underlying provider.
+     *
+     * @param params - Normalized send parameters.
+     * @returns A promise that resolves when the provider accepts the email.
+     * @throws IgniterMailError When configuration is invalid or provider call fails.
+     * @example
+     * ```ts
+     * await adapter.send({ to: 'a@b.com', subject: 'Hi', html: '<p>x</p>', text: 'x' })
+     * ```
+     */
+    send: (params: IgniterMailAdapterSendParams) => Promise<void>;
+}
+
+/**
+ * Postmark adapter.
+ *
+ * Notes:
+ * - This implementation uses `fetch` (no SDK dependency).
+ * - Designed to be extracted to `@igniter-js/mail/adapters/postmark`.
+ *
+ * @example
+ * ```ts
+ * const adapter = PostmarkMailAdapter.create({
+ *   secret: process.env.POSTMARK_SERVER_TOKEN,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class PostmarkMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * Resend adapter implementation.
+ *
+ * Notes:
+ * - Uses the Resend SDK.
+ * - Designed to be extracted to `@igniter-js/mail/adapters/resend`.
+ *
+ * @example
+ * ```ts
+ * const adapter = ResendMailAdapter.create({
+ *   secret: process.env.RESEND_API_KEY,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class ResendMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * SendGrid adapter implementation.
+ *
+ * Notes:
+ * - This implementation uses `fetch` (no SDK dependency).
+ * - Designed to be extracted to `@igniter-js/mail/adapters/sendgrid`.
+ *
+ * @example
+ * ```ts
+ * const adapter = SendGridMailAdapter.create({
+ *   secret: process.env.SENDGRID_API_KEY,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class SendGridMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * SMTP adapter implementation.
+ *
+ * Notes:
+ * - Uses Nodemailer.
+ * - `credentials.secret` must be an SMTP connection URL.
+ *
+ * @example
+ * ```ts
+ * const adapter = SmtpMailAdapter.create({
+ *   secret: 'smtps://user:pass@host:465',
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class SmtpMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * In-memory mock adapter for `@igniter-js/mail`.
+ *
+ * Use this in tests to avoid real provider calls.
+ */
+declare class MockMailAdapter implements IgniterMailAdapter {
+    /** Creates a new mock adapter instance. */
+    static create(): MockMailAdapter;
+    /** Tracks all send calls. */
+    readonly sent: IgniterMailAdapterSendParams[];
+    /** Tracks method call counts. */
+    readonly calls: {
+        send: number;
+    };
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+    /** Clears all tracked state. */
+    clear(): void;
+}
+
+export { type IgniterMailAdapter as I, MockMailAdapter as M, PostmarkMailAdapter as P, ResendMailAdapter as R, SendGridMailAdapter as S, type IgniterMailAdapterSendParams as a, type IgniterMailAdapterCredentials as b, SmtpMailAdapter as c };

package/dist/index-CbiH0sth.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Parameters used by a mail adapter to send an email.
+ *
+ * @example
+ * ```ts
+ * await adapter.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome',
+ *   html: '<p>Hello</p>',
+ *   text: 'Hello',
+ * })
+ * ```
+ */
+interface IgniterMailAdapterSendParams {
+    /** Recipient email address. */
+    to: string;
+    /** Email subject. */
+    subject: string;
+    /** HTML body. */
+    html: string;
+    /** Plain-text body. */
+    text: string;
+    /** Optional provider-level scheduled send date. */
+    scheduledAt?: Date;
+}
+/**
+ * Credentials required by mail adapters.
+ *
+ * @example
+ * ```ts
+ * const credentials = { secret: process.env.RESEND_API_KEY, from: 'no-reply@acme.com' }
+ * ```
+ */
+interface IgniterMailAdapterCredentials {
+    /** Provider secret, token, or connection URL. */
+    secret?: string;
+    /** Default FROM address used by the provider. */
+    from?: string;
+}
+/**
+ * Adapter interface used by {@link IgniterMail}.
+ *
+ * Adapters will eventually be imported from `@igniter-js/mail/adapters`.
+ */
+interface IgniterMailAdapter {
+    /**
+     * Sends an email using the underlying provider.
+     *
+     * @param params - Normalized send parameters.
+     * @returns A promise that resolves when the provider accepts the email.
+     * @throws IgniterMailError When configuration is invalid or provider call fails.
+     * @example
+     * ```ts
+     * await adapter.send({ to: 'a@b.com', subject: 'Hi', html: '<p>x</p>', text: 'x' })
+     * ```
+     */
+    send: (params: IgniterMailAdapterSendParams) => Promise<void>;
+}
+
+/**
+ * Postmark adapter.
+ *
+ * Notes:
+ * - This implementation uses `fetch` (no SDK dependency).
+ * - Designed to be extracted to `@igniter-js/mail/adapters/postmark`.
+ *
+ * @example
+ * ```ts
+ * const adapter = PostmarkMailAdapter.create({
+ *   secret: process.env.POSTMARK_SERVER_TOKEN,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class PostmarkMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * Resend adapter implementation.
+ *
+ * Notes:
+ * - Uses the Resend SDK.
+ * - Designed to be extracted to `@igniter-js/mail/adapters/resend`.
+ *
+ * @example
+ * ```ts
+ * const adapter = ResendMailAdapter.create({
+ *   secret: process.env.RESEND_API_KEY,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class ResendMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * SendGrid adapter implementation.
+ *
+ * Notes:
+ * - This implementation uses `fetch` (no SDK dependency).
+ * - Designed to be extracted to `@igniter-js/mail/adapters/sendgrid`.
+ *
+ * @example
+ * ```ts
+ * const adapter = SendGridMailAdapter.create({
+ *   secret: process.env.SENDGRID_API_KEY,
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class SendGridMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * SMTP adapter implementation.
+ *
+ * Notes:
+ * - Uses Nodemailer.
+ * - `credentials.secret` must be an SMTP connection URL.
+ *
+ * @example
+ * ```ts
+ * const adapter = SmtpMailAdapter.create({
+ *   secret: 'smtps://user:pass@host:465',
+ *   from: 'no-reply@example.com',
+ * })
+ * await adapter.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hi</p>', text: 'Hi' })
+ * ```
+ */
+declare class SmtpMailAdapter implements IgniterMailAdapter {
+    private readonly 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: IgniterMailAdapterCredentials): 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?: IgniterMailAdapterCredentials);
+    /**
+     * 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' })
+     * ```
+     */
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+}
+
+/**
+ * In-memory mock adapter for `@igniter-js/mail`.
+ *
+ * Use this in tests to avoid real provider calls.
+ */
+declare class MockMailAdapter implements IgniterMailAdapter {
+    /** Creates a new mock adapter instance. */
+    static create(): MockMailAdapter;
+    /** Tracks all send calls. */
+    readonly sent: IgniterMailAdapterSendParams[];
+    /** Tracks method call counts. */
+    readonly calls: {
+        send: number;
+    };
+    send(params: IgniterMailAdapterSendParams): Promise<void>;
+    /** Clears all tracked state. */
+    clear(): void;
+}
+
+export { type IgniterMailAdapter as I, MockMailAdapter as M, PostmarkMailAdapter as P, ResendMailAdapter as R, SendGridMailAdapter as S, type IgniterMailAdapterSendParams as a, type IgniterMailAdapterCredentials as b, SmtpMailAdapter as c };

package/dist/index.d.mts

@@ -1,15 +1,8 @@
 import { StandardSchemaV1, JobLimiter, IgniterLogger, IgniterJobQueueAdapter, IgniterError } from '@igniter-js/core';
-import { I as IgniterMailAdapter } from './adapter-BhnIsrlh.mjs';
-export { b as IgniterMailAdapterCredentials, a as IgniterMailAdapterSendParams } from './adapter-BhnIsrlh.mjs';
-import { IgniterTelemetryManager } from '@igniter-js/telemetry';
-import { IgniterMailTelemetryEvents } from './telemetry/index.mjs';
+import { I as IgniterMailAdapter } from './index-CbiH0sth.mjs';
+export { b as IgniterMailAdapterCredentials, a as IgniterMailAdapterSendParams, M as MockMailAdapter, P as PostmarkMailAdapter, R as ResendMailAdapter, S as SendGridMailAdapter, c as SmtpMailAdapter } from './index-CbiH0sth.mjs';
 import { ReactElement } from 'react';
-import 'zod';
-
-type IgniterMailTelemetryRegistry = {
-    [K in IgniterMailTelemetryEvents["namespace"]]: IgniterMailTelemetryEvents["events"];
-};
-type IgniterMailTelemetry = IgniterTelemetryManager<IgniterMailTelemetryRegistry>;
+import { IgniterTelemetryManager } from '@igniter-js/telemetry';
 
 /**
  * Email template definition used by {@link IgniterMail}.
@@ -127,7 +120,7 @@ interface IgniterMailOptions<TTemplates extends object = Record<string, IgniterM
     /** Optional logger used for debug/info/error logging. */
     logger?: IgniterLogger;
     /** Optional telemetry instance for observability. */
-    telemetry?: IgniterMailTelemetry;
+    telemetry?: IgniterTelemetryManager<any>;
     /** Optional queue configuration for asynchronous delivery. */
     queue?: IgniterMailQueueConfig;
 }
@@ -171,7 +164,7 @@ declare class IgniterMailBuilder<TTemplates extends Record<string, IgniterMailTe
     /** Attaches a logger instance. */
     withLogger(logger: IgniterLogger): this;
     /** Attaches a telemetry instance for observability. */
-    withTelemetry(telemetry: IgniterMailTelemetry): this;
+    withTelemetry(telemetry: IgniterTelemetryManager<any>): this;
     /**
      * Enables queue delivery.
      *

package/dist/index.d.ts

@@ -1,15 +1,8 @@
 import { StandardSchemaV1, JobLimiter, IgniterLogger, IgniterJobQueueAdapter, IgniterError } from '@igniter-js/core';
-import { I as IgniterMailAdapter } from './adapter-BhnIsrlh.js';
-export { b as IgniterMailAdapterCredentials, a as IgniterMailAdapterSendParams } from './adapter-BhnIsrlh.js';
-import { IgniterTelemetryManager } from '@igniter-js/telemetry';
-import { IgniterMailTelemetryEvents } from './telemetry/index.js';
+import { I as IgniterMailAdapter } from './index-CbiH0sth.js';
+export { b as IgniterMailAdapterCredentials, a as IgniterMailAdapterSendParams, M as MockMailAdapter, P as PostmarkMailAdapter, R as ResendMailAdapter, S as SendGridMailAdapter, c as SmtpMailAdapter } from './index-CbiH0sth.js';
 import { ReactElement } from 'react';
-import 'zod';
-
-type IgniterMailTelemetryRegistry = {
-    [K in IgniterMailTelemetryEvents["namespace"]]: IgniterMailTelemetryEvents["events"];
-};
-type IgniterMailTelemetry = IgniterTelemetryManager<IgniterMailTelemetryRegistry>;
+import { IgniterTelemetryManager } from '@igniter-js/telemetry';
 
 /**
  * Email template definition used by {@link IgniterMail}.
@@ -127,7 +120,7 @@ interface IgniterMailOptions<TTemplates extends object = Record<string, IgniterM
     /** Optional logger used for debug/info/error logging. */
     logger?: IgniterLogger;
     /** Optional telemetry instance for observability. */
-    telemetry?: IgniterMailTelemetry;
+    telemetry?: IgniterTelemetryManager<any>;
     /** Optional queue configuration for asynchronous delivery. */
     queue?: IgniterMailQueueConfig;
 }
@@ -171,7 +164,7 @@ declare class IgniterMailBuilder<TTemplates extends Record<string, IgniterMailTe
     /** Attaches a logger instance. */
     withLogger(logger: IgniterLogger): this;
     /** Attaches a telemetry instance for observability. */
-    withTelemetry(telemetry: IgniterMailTelemetry): this;
+    withTelemetry(telemetry: IgniterTelemetryManager<any>): this;
     /**
      * Enables queue delivery.
      *