import { APIResource } from "../core/resource.mjs";
import { APIPromise } from "../core/api-promise.mjs";
import { RequestOptions } from "../internal/request-options.mjs";
/**
 * Send emails via AWS SES.
 */
export declare class Email extends APIResource {
    /**
     * Send an email via AWS SES.
     *
     * This is a fire-and-forget endpoint — the email is sent but not persisted to any
     * database or thread.
     */
    send(body: EmailSendParams, options?: RequestOptions): APIPromise<EmailSendResponse>;
}
/**
 * Response returned after successfully sending an email.
 */
export interface EmailSendResponse {
    /**
     * The AWS SES message ID for tracking.
     */
    ses_message_id: string;
}
export interface EmailSendParams {
    /**
     * Plain-text email body.
     */
    body: string;
    /**
     * Email subject line.
     */
    subject: string;
    /**
     * List of recipient email addresses.
     */
    to: Array<string>;
    /**
     * Attachments to include with the email.
     */
    attachments?: Array<EmailSendParams.Attachment>;
    /**
     * List of BCC email addresses.
     */
    bcc?: Array<string>;
    /**
     * List of CC email addresses.
     */
    cc?: Array<string>;
    /**
     * Display name for the sender. Defaults to "Village".
     */
    from_name?: string | null;
    /**
     * HTML email body.
     */
    html_body?: string | null;
}
export declare namespace EmailSendParams {
    /**
     * Attachment payload for a send-email request.
     */
    interface Attachment {
        /**
         * Base64-encoded attachment bytes.
         */
        content_base64: string;
        /**
         * MIME content type for the attachment, such as image/png.
         */
        content_type: string;
        /**
         * Filename to present in the email client.
         */
        filename: string;
        /**
         * Required for inline attachments; reference from HTML as cid:<content_id>.
         */
        content_id?: string | null;
        /**
         * Whether the attachment should be inline or downloadable.
         */
        disposition?: 'inline' | 'attachment';
    }
}
export declare namespace Email {
    export { type EmailSendResponse as EmailSendResponse, type EmailSendParams as EmailSendParams };
}
//# sourceMappingURL=email.d.mts.map