@igniter-js/mail 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -1,35 +1,20 @@
-import { StandardSchemaV1, IgniterLogger, IgniterJobQueueAdapter, JobQueueConfig, JobLimiter, IgniterError } from '@igniter-js/core';
+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 { ReactElement } from 'react';
+import 'zod';
 
-/**
- * Parameters used by a mail adapter to send an email.
- */
-interface MailAdapterSendParams {
-    /** 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;
-}
-/**
- * Adapter interface used by {@link IgniterMail}.
- *
- * Adapters will eventually be imported from `@igniter-js/mail/adapters`.
- */
-interface MailAdapter {
-    /** Sends an email using the underlying provider. */
-    send: (params: MailAdapterSendParams) => Promise<void>;
-}
+type IgniterMailTelemetryRegistry = {
+    [K in IgniterMailTelemetryEvents["namespace"]]: IgniterMailTelemetryEvents["events"];
+};
+type IgniterMailTelemetry = IgniterTelemetryManager<IgniterMailTelemetryRegistry>;
 
 /**
  * Email template definition used by {@link IgniterMail}.
  */
-interface IgniterMailTemplate<TSchema extends StandardSchemaV1> {
+interface IgniterMailTemplateBuilt<TSchema extends StandardSchemaV1> {
     /** Default subject for the template (can be overridden per-send). */
     subject: string;
     /** Schema used to validate and infer template payload. */
@@ -40,38 +25,38 @@ interface IgniterMailTemplate<TSchema extends StandardSchemaV1> {
 /**
  * Extracts the valid template keys from a template map.
  */
-type MailTemplateKey<TTemplates extends object> = {
-    [K in keyof TTemplates]: TTemplates[K] extends IgniterMailTemplate<any> ? K : never;
+type IgniterMailTemplateKey<TTemplates extends object> = {
+    [K in keyof TTemplates]: TTemplates[K] extends IgniterMailTemplateBuilt<any> ? K : never;
 }[keyof TTemplates] & string;
 /**
  * Extracts the payload type from a template.
  */
-type MailTemplatePayload<TTemplate> = TTemplate extends IgniterMailTemplate<infer TSchema> ? StandardSchemaV1.InferInput<TSchema> : never;
+type IgniterMailTemplatePayload<TTemplate> = TTemplate extends IgniterMailTemplateBuilt<infer TSchema> ? StandardSchemaV1.InferInput<TSchema> : never;
 
 /**
  * Type inference helper exposed by the runtime instance.
  */
 type IgniterMailInfer<TTemplates extends object> = {
     /** Union of valid template keys. */
-    readonly Templates: MailTemplateKey<TTemplates>;
+    readonly Templates: IgniterMailTemplateKey<TTemplates>;
     /** Payloads by template. */
     readonly Payloads: {
-        [K in MailTemplateKey<TTemplates>]: MailTemplatePayload<TTemplates[K]>;
+        [K in IgniterMailTemplateKey<TTemplates>]: IgniterMailTemplatePayload<TTemplates[K]>;
     };
     /**
      * Union of valid `mail.send()` inputs.
      * Useful for type-level consumption.
      */
     readonly SendInput: {
-        [K in MailTemplateKey<TTemplates>]: IgniterMailSendParams<TTemplates, K>;
-    }[MailTemplateKey<TTemplates>];
+        [K in IgniterMailTemplateKey<TTemplates>]: IgniterMailSendParams<TTemplates, K>;
+    }[IgniterMailTemplateKey<TTemplates>];
     /**
      * Tuple form of `mail.schedule()` inputs.
      */
     readonly ScheduleInput: [
         {
-            [K in MailTemplateKey<TTemplates>]: IgniterMailSendParams<TTemplates, K>;
-        }[MailTemplateKey<TTemplates>],
+            [K in IgniterMailTemplateKey<TTemplates>]: IgniterMailSendParams<TTemplates, K>;
+        }[IgniterMailTemplateKey<TTemplates>],
         Date
     ];
 };
@@ -79,14 +64,10 @@ type IgniterMailInfer<TTemplates extends object> = {
  * Queue options used when scheduling or enqueuing send jobs.
  */
 type IgniterMailQueueOptions = {
-    /** Namespace used to compose the job id (default: "mail"). */
-    namespace?: string;
-    /** Task key used to compose the job id (default: "send"). */
-    task?: string;
-    /** Human-readable job name (default: "send"). */
-    name?: string;
-    /** Queue config for this job. */
-    queue?: JobQueueConfig;
+    /** Job name (default: "send"). */
+    job?: string;
+    /** Queue name. */
+    queue?: string;
     /** Number of retry attempts on failure. */
     attempts?: number;
     /** Job priority (higher value = higher priority). */
@@ -106,15 +87,13 @@ type IgniterMailQueueOptions = {
 type IgniterMailQueueConfig = {
     /** Queue adapter instance. */
     adapter: IgniterJobQueueAdapter<any>;
-    /** Fully qualified job id. */
-    id: string;
     /** Optional queue options. */
     options?: IgniterMailQueueOptions;
 };
 /**
  * Parameters required to send an email using a template.
  */
-interface IgniterMailSendParams<TTemplates extends object, TSelectedTemplate extends MailTemplateKey<TTemplates>> {
+interface IgniterMailSendParams<TTemplates extends object, TSelectedTemplate extends IgniterMailTemplateKey<TTemplates>> {
     /** Recipient email address. */
     to: string;
     /** Optional subject override. */
@@ -122,7 +101,7 @@ interface IgniterMailSendParams<TTemplates extends object, TSelectedTemplate ext
     /** Template key. */
     template: TSelectedTemplate;
     /** Template payload (validated using StandardSchema when provided). */
-    data: MailTemplatePayload<TTemplates[TSelectedTemplate]>;
+    data: IgniterMailTemplatePayload<TTemplates[TSelectedTemplate]>;
 }
 /**
  * Hooks invoked by the runtime.
@@ -138,33 +117,20 @@ interface IgniterMailHooks<TTemplates extends object> {
 /**
  * Options used to initialize {@link IgniterMail}.
  */
-interface IgniterMailOptions<TTemplates extends object = Record<string, IgniterMailTemplate<any>>> extends IgniterMailHooks<TTemplates> {
+interface IgniterMailOptions<TTemplates extends object = Record<string, IgniterMailTemplateBuilt<any>>> extends IgniterMailHooks<TTemplates> {
     /** Default FROM address used by the adapter. */
     from: string;
     /** Adapter implementation. */
-    adapter: MailAdapter;
+    adapter: IgniterMailAdapter;
     /** Template registry. */
     templates: TTemplates;
     /** Optional logger used for debug/info/error logging. */
     logger?: IgniterLogger;
+    /** Optional telemetry instance for observability. */
+    telemetry?: IgniterMailTelemetry;
     /** Optional queue configuration for asynchronous delivery. */
     queue?: IgniterMailQueueConfig;
 }
-/**
- * Legacy initializer options.
- *
- * Kept for backwards compatibility with older integrations.
- */
-interface LegacyIgniterMailOptions<TTemplates extends object = Record<string, IgniterMailTemplate<any>>> extends IgniterMailHooks<TTemplates> {
-    /** Provider secret/token. */
-    secret: string;
-    /** Default FROM address. */
-    from: string;
-    /** Adapter factory. */
-    adapter: (options: LegacyIgniterMailOptions<any>) => MailAdapter;
-    /** Template registry. */
-    templates: TTemplates;
-}
 /**
  * Public interface implemented by {@link IgniterMail}.
  */
@@ -175,192 +141,41 @@ interface IIgniterMail<TTemplates extends object> {
      */
     readonly $Infer: IgniterMailInfer<TTemplates>;
     /** Sends an email immediately. */
-    send: <TSelectedTemplate extends MailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>) => Promise<void>;
-    /** Schedules an email for a future date (queue if configured, otherwise setTimeout). */
-    schedule: <TSelectedTemplate extends MailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>, date: Date) => Promise<void>;
-}
-/**
- * Helper for creating a passthrough `StandardSchemaV1` validator.
- */
-declare function createPassthroughSchema(): StandardSchemaV1;
-
-/**
- * Postmark adapter builder.
- *
- * Notes:
- * - This implementation uses `fetch` (no SDK dependency).
- * - Designed to be extracted to `@igniter-js/mail/adapters/postmark`.
- */
-declare class PostmarkMailAdapterBuilder {
-    private secret?;
-    private from?;
-    /** Creates a new builder instance. */
-    static create(): PostmarkMailAdapterBuilder;
-    /** Sets the Postmark Server Token. */
-    withSecret(secret: string): this;
-    /** Sets the default FROM address used when sending emails via Postmark. */
-    withFrom(from: string): this;
-    /** Builds the adapter instance. */
-    build(): MailAdapter;
-}
-/**
- * Legacy adapter factory.
- */
-declare const postmarkAdapter: (options: LegacyIgniterMailOptions) => MailAdapter;
-
-declare class ResendMailAdapterBuilder {
-    private secret?;
-    private from?;
-    /** Creates a new builder instance. */
-    static create(): ResendMailAdapterBuilder;
-    /** Sets the Resend API key. */
-    withSecret(secret: string): this;
-    /** Sets the default FROM address used when sending emails via Resend. */
-    withFrom(from: string): this;
-    /** Builds the adapter instance. */
-    build(): MailAdapter;
-}
-/**
- * Legacy adapter factory.
- */
-declare const resendAdapter: (options: LegacyIgniterMailOptions) => MailAdapter;
-
-/**
- * SendGrid adapter builder.
- *
- * Notes:
- * - This implementation uses `fetch` (no SDK dependency).
- * - Designed to be extracted to `@igniter-js/mail/adapters/sendgrid`.
- */
-declare class SendGridMailAdapterBuilder {
-    private secret?;
-    private from?;
-    /** Creates a new builder instance. */
-    static create(): SendGridMailAdapterBuilder;
-    /** Sets the SendGrid API key. */
-    withSecret(secret: string): this;
-    /** Sets the default FROM address used when sending emails via SendGrid. */
-    withFrom(from: string): this;
-    /** Builds the adapter instance. */
-    build(): MailAdapter;
-}
-/**
- * Legacy adapter factory.
- */
-declare const sendgridAdapter: (options: LegacyIgniterMailOptions) => MailAdapter;
-
-declare class SmtpMailAdapterBuilder {
-    private secret?;
-    private from?;
-    /** Creates a new builder instance. */
-    static create(): SmtpMailAdapterBuilder;
-    /** Sets the SMTP connection URL (e.g. `smtps://user:pass@host:port`). */
-    withSecret(secret: string): this;
-    /** Sets the default FROM address used when sending emails via SMTP. */
-    withFrom(from: string): this;
-    /** Builds the adapter instance. */
-    build(): MailAdapter;
-}
-/**
- * Legacy adapter factory.
- */
-declare const smtpAdapter: (options: LegacyIgniterMailOptions) => MailAdapter;
-
-/**
- * In-memory message captured by {@link TestMailAdapter}.
- */
-type TestMailMessage = MailAdapterSendParams & {
-    /** Timestamp when `send()` was called. */
-    at: Date;
-};
-/**
- * A test-focused adapter that captures emails in memory.
- *
- * Why this exists:
- * - Allows unit tests to assert subjects/recipients/content without hitting a real provider.
- * - Can optionally log the send operation for local debugging.
- *
- * This adapter is intentionally dependency-free so it can live in `@igniter-js/mail/adapters`.
- */
-type TestMailAdapter = MailAdapter & {
-    /** Captured sent messages, in order. */
-    readonly sent: TestMailMessage[];
-    /** Clears captured messages. */
-    reset: () => void;
-    /** Returns the last captured message (if any). */
-    last: () => TestMailMessage | undefined;
-};
-type CreateTestMailAdapterOptions = {
-    /** Optional logger; defaults to `console`. */
-    logger?: Pick<IgniterLogger, 'info'>;
-    /** Whether to suppress logs. Default: `false`. */
-    silent?: boolean;
-};
-/**
- * Creates a {@link TestMailAdapter}.
- */
-declare function createTestMailAdapter(options?: CreateTestMailAdapterOptions): TestMailAdapter;
-
-/**
- * Webhook adapter builder.
- *
- * This adapter posts the email payload to an arbitrary HTTP endpoint.
- *
- * Why this exists:
- * - Useful for low-code automation (Make/Zapier/n8n) or custom internal relays.
- * - Dependency-free (uses `fetch`).
- * - Easy to extract as `@igniter-js/mail/adapters/webhook`.
- */
-declare class WebhookMailAdapterBuilder {
-    private url?;
-    private from?;
-    /** Creates a new builder instance. */
-    static create(): WebhookMailAdapterBuilder;
-    /**
-     * Sets the webhook URL.
-     *
-     * Note: when using `IgniterMailBuilder.withAdapter('webhook', secret)`, the `secret`
-     * is treated as the webhook URL.
-     */
-    withUrl(url: string): this;
-    /** Sets the default FROM address. */
-    withFrom(from: string): this;
-    /** Builds the adapter instance. */
-    build(): MailAdapter;
+    send: <TSelectedTemplate extends IgniterMailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>) => Promise<void>;
+    /** Schedules an email for a future date (requires queue adapter). */
+    schedule: <TSelectedTemplate extends IgniterMailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>, date: Date) => Promise<void>;
 }
-/**
- * Legacy adapter factory.
- */
-declare const webhookAdapter: (options: LegacyIgniterMailOptions) => MailAdapter;
 
 /**
  * Builder for {@link IgniterMail}.
  *
  * This API is designed to remain stable when extracted to `@igniter-js/mail`.
  */
-declare class IgniterMailBuilder<TTemplates extends object = Record<never, never>> {
-    private readonly factory;
+declare class IgniterMailBuilder<TTemplates extends Record<string, IgniterMailTemplateBuilt<any>> = Record<string, IgniterMailTemplateBuilt<any>>> {
     private from?;
     private adapter?;
     private templates;
     private logger?;
+    private telemetry?;
     private queue?;
-    private onSendStarted?;
-    private onSendError?;
-    private onSendSuccess?;
+    private onSendStartedHandler?;
+    private onSendErrorHandler?;
+    private onSendSuccessHandler?;
     private constructor();
     /**
      * Creates a new builder.
      */
-    static create(factory: (options: IgniterMailOptions<any>) => IIgniterMail<any>): IgniterMailBuilder<Record<never, never>>;
+    static create(): IgniterMailBuilder<{}>;
     /** Sets the default FROM address. */
     withFrom(from: string): this;
     /** Attaches a logger instance. */
     withLogger(logger: IgniterLogger): this;
+    /** Attaches a telemetry instance for observability. */
+    withTelemetry(telemetry: IgniterMailTelemetry): this;
     /**
      * Enables queue delivery.
      *
-     * If configured, `IgniterMail.schedule()` will enqueue jobs instead of using `setTimeout`.
+     * When configured, `IgniterMail.schedule()` will enqueue jobs using the queue adapter.
      */
     withQueue(adapter: IgniterJobQueueAdapter<any>, options?: IgniterMailQueueOptions): this;
     /**
@@ -369,53 +184,55 @@ declare class IgniterMailBuilder<TTemplates extends object = Record<never, never
      * - Use an adapter instance for full control.
      * - Or pass a provider key + secret for built-in adapters.
      */
-    withAdapter(adapter: MailAdapter): this;
+    withAdapter(adapter: IgniterMailAdapter): this;
     withAdapter(provider: string, secret: string): this;
     /**
      * Registers a template.
      */
-    addTemplate<TKey extends string, TTemplate extends IgniterMailTemplate<any>>(key: TKey, template: TTemplate): IgniterMailBuilder<TTemplates & Record<TKey, TTemplate>>;
+    addTemplate<TKey extends string, TTemplate extends IgniterMailTemplateBuilt<any>>(key: TKey, template: TTemplate): IgniterMailBuilder<TTemplates & { [K in TKey]: TTemplate; }>;
     /** Hook invoked before sending. */
-    withOnSendStarted(onSendStarted: (params: IgniterMailSendParams<Record<string, IgniterMailTemplate<any>>, any>) => Promise<void>): this;
+    onSendStarted(handler: (params: IgniterMailSendParams<Record<string, IgniterMailTemplateBuilt<any>>, any>) => Promise<void>): this;
     /** Hook invoked on error. */
-    withOnSendError(onSendError: (params: IgniterMailSendParams<Record<string, IgniterMailTemplate<any>>, any>, error: Error) => Promise<void>): this;
+    onSendError(handler: (params: IgniterMailSendParams<Record<string, IgniterMailTemplateBuilt<any>>, any>, error: Error) => Promise<void>): this;
     /** Hook invoked on success. */
-    withOnSendSuccess(onSendSuccess: (params: IgniterMailSendParams<Record<string, IgniterMailTemplate<any>>, any>) => Promise<void>): this;
+    onSendSuccess(handler: (params: IgniterMailSendParams<Record<string, IgniterMailTemplateBuilt<any>>, any>) => Promise<void>): this;
     /**
      * Builds the {@link IgniterMail} instance.
      */
     build(): IIgniterMail<TTemplates>;
 }
+declare const IgniterMail: typeof IgniterMailBuilder;
 
 /**
  * Builder for {@link IgniterMailTemplate}.
  */
-declare class MailTemplateBuilder<TSchema extends StandardSchemaV1 = StandardSchemaV1> {
+declare class IgniterMailTemplateBuilder<TSchema extends StandardSchemaV1 = StandardSchemaV1> {
     private subject?;
     private schema?;
     private render?;
     /** Creates a new builder instance. */
-    static create(): MailTemplateBuilder<any>;
+    static create(): IgniterMailTemplateBuilder<any>;
     /** Sets the default subject for the template. */
     withSubject(subject: string): this;
     /** Attaches the schema used to validate and infer payload types. */
-    withSchema<TNextSchema extends StandardSchemaV1>(schema: TNextSchema): MailTemplateBuilder<TNextSchema>;
+    withSchema<TNextSchema extends StandardSchemaV1>(schema: TNextSchema): IgniterMailTemplateBuilder<TNextSchema>;
     /** Sets the React Email render function for the template. */
     withRender(render: (data: StandardSchemaV1.InferInput<TSchema>) => ReactElement): this;
     /** Builds the template definition. */
-    build(): IgniterMailTemplate<TSchema>;
+    build(): IgniterMailTemplateBuilt<TSchema>;
 }
+declare const IgniterMailTemplate: typeof IgniterMailTemplateBuilder;
 
 /**
  * Mail runtime for Igniter.js.
  *
  * This class is designed to be extracted into the `@igniter-js/mail` package.
  */
-declare class IgniterMail<TTemplates extends object> implements IIgniterMail<TTemplates> {
-    private static instance;
+declare class IgniterMailManagerCore<TTemplates extends object> implements IIgniterMail<TTemplates> {
     private readonly adapter;
     private readonly templates;
     private readonly logger?;
+    private readonly telemetry?;
     private readonly queue?;
     private queueJobRegistered;
     private queueJobRegistering?;
@@ -431,37 +248,22 @@ declare class IgniterMail<TTemplates extends object> implements IIgniterMail<TTe
     /**
      * Sends an email immediately.
      */
-    send<TSelectedTemplate extends MailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>): Promise<void>;
+    send<TSelectedTemplate extends IgniterMailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>): Promise<void>;
     /**
      * Schedules an email for a future date.
      *
-     * If a queue is configured, this method enqueues a job.
-     * Otherwise, it uses a best-effort `setTimeout`.
+     * Requires a queue adapter; otherwise it throws.
      */
-    schedule<TSelectedTemplate extends MailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>, date: Date): Promise<void>;
+    schedule<TSelectedTemplate extends IgniterMailTemplateKey<TTemplates>>(params: IgniterMailSendParams<TTemplates, TSelectedTemplate>, date: Date): Promise<void>;
     private onSendStarted;
     private onSendError;
     private onSendSuccess;
-    /** Helper to declare adapter factories. */
-    static adapter: <TOptions>(adapter: (options: TOptions) => MailAdapter) => (options: TOptions) => MailAdapter;
-    /** Helper to declare templates with inferred payload types. */
-    static template: <TSchema extends StandardSchemaV1>(template: IgniterMailTemplate<TSchema>) => IgniterMailTemplate<TSchema>;
-    /**
-     * Creates a new builder instance.
-     */
-    static create: () => IgniterMailBuilder<Record<never, never>>;
-    /**
-     * Initializes (singleton) instance.
-     *
-     * Prefer using {@link IgniterMail.create} for new code.
-     */
-    static initialize: <TEmailTemplates extends object>(options: IgniterMailOptions<TEmailTemplates> | LegacyIgniterMailOptions<TEmailTemplates>) => IgniterMail<TEmailTemplates>;
 }
 
 /**
  * Known error codes thrown by `@igniter-js/mail` runtime.
  */
-type IgniterMailErrorCode = 'MAIL_PROVIDER_FROM_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_SECRET_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_NOT_FOUND' | 'MAIL_PROVIDER_TEMPLATES_REQUIRED' | 'MAIL_PROVIDER_TEMPLATE_NOT_FOUND' | 'MAIL_PROVIDER_TEMPLATE_DATA_INVALID' | 'MAIL_PROVIDER_SCHEDULE_DATE_INVALID' | 'MAIL_PROVIDER_SEND_FAILED' | 'MAIL_PROVIDER_SCHEDULE_FAILED' | 'MAIL_ADAPTER_CONFIGURATION_INVALID' | 'MAIL_TEMPLATE_CONFIGURATION_INVALID';
+type IgniterMailErrorCode = 'MAIL_PROVIDER_FROM_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_SECRET_REQUIRED' | 'MAIL_PROVIDER_ADAPTER_NOT_FOUND' | 'MAIL_PROVIDER_TEMPLATES_REQUIRED' | 'MAIL_PROVIDER_TEMPLATE_NOT_FOUND' | 'MAIL_PROVIDER_TEMPLATE_DATA_INVALID' | 'MAIL_PROVIDER_SCHEDULE_DATE_INVALID' | 'MAIL_PROVIDER_SEND_FAILED' | 'MAIL_PROVIDER_SCHEDULE_FAILED' | 'MAIL_ADAPTER_CONFIGURATION_INVALID' | 'MAIL_TEMPLATE_CONFIGURATION_INVALID' | 'MAIL_PROVIDER_SCHEDULE_QUEUE_NOT_CONFIGURED';
 /**
  * Payload used to create an {@link IgniterMailError}.
  */
@@ -496,15 +298,19 @@ declare class IgniterMailError extends IgniterError {
 }
 
 /**
- * Resolves a legacy adapter factory by key.
- */
-declare const getAdapter: (adapter: string) => (options: LegacyIgniterMailOptions) => MailAdapter;
-
-/**
- * Validates an unknown input using `StandardSchemaV1` when the schema provides `~standard.validate`.
- *
- * If the schema does not provide a validator, this function returns the input as-is.
+ * Schema utilities for `@igniter-js/mail`.
  */
-declare function validateStandardSchemaInput<TSchema extends StandardSchemaV1>(schema: TSchema, input: unknown): Promise<StandardSchemaV1.InferInput<TSchema>>;
+declare class IgniterMailSchema {
+    /**
+     * Validates an unknown input using `StandardSchemaV1` when the schema provides `~standard.validate`.
+     *
+     * If the schema does not provide a validator, this method returns the input as-is.
+     */
+    static validateInput<TSchema extends StandardSchemaV1>(schema: TSchema, input: unknown): Promise<StandardSchemaV1.InferInput<TSchema>>;
+    /**
+     * Creates a passthrough StandardSchema validator.
+     */
+    static createPassthroughSchema(): StandardSchemaV1;
+}
 
-export { type CreateTestMailAdapterOptions, type IIgniterMail, IgniterMail, IgniterMailBuilder, IgniterMailError, type IgniterMailErrorCode, type IgniterMailErrorPayload, type IgniterMailHooks, type IgniterMailInfer, type IgniterMailOptions, type IgniterMailQueueConfig, type IgniterMailQueueOptions, type IgniterMailSendParams, type IgniterMailTemplate, type LegacyIgniterMailOptions, type MailAdapter, type MailAdapterSendParams, MailTemplateBuilder, type MailTemplateKey, type MailTemplatePayload, PostmarkMailAdapterBuilder, ResendMailAdapterBuilder, SendGridMailAdapterBuilder, SmtpMailAdapterBuilder, type TestMailAdapter, type TestMailMessage, WebhookMailAdapterBuilder, createPassthroughSchema, createTestMailAdapter, getAdapter, postmarkAdapter, resendAdapter, sendgridAdapter, smtpAdapter, validateStandardSchemaInput, webhookAdapter };
+export { type IIgniterMail, IgniterMail, IgniterMailAdapter, IgniterMailBuilder, IgniterMailError, type IgniterMailErrorCode, type IgniterMailErrorPayload, type IgniterMailHooks, type IgniterMailInfer, IgniterMailManagerCore, type IgniterMailOptions, type IgniterMailQueueConfig, type IgniterMailQueueOptions, IgniterMailSchema, type IgniterMailSendParams, IgniterMailTemplate, IgniterMailTemplateBuilder, type IgniterMailTemplateBuilt, type IgniterMailTemplateKey, type IgniterMailTemplatePayload };