@visulima/email 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/mail-message.d.ts

@@ -1,425 +0,0 @@
-import type { ICalCalendar } from "ical-generator";
-import type { AttachmentDataOptions, AttachmentOptions } from './attachment-helpers.d.ts';
-import type { EmailEncrypter, EmailSigner } from './crypto/index.d.ts';
-import type { TemplateRenderer } from './template-engines/types.d.ts';
-import type { Attachment, CalendarEventOptions, EmailAddress, EmailHeaders, EmailOptions, Priority } from './types.d.ts';
-type AddressInput = EmailAddress | EmailAddress[] | string | string[];
-/**
- * Mail message builder - provides fluent interface for building emails.
- */
-export declare class MailMessage {
-    private fromAddress?;
-    private toAddresses;
-    private ccAddresses;
-    private bccAddresses;
-    private subjectText;
-    private textContent?;
-    private textCharset;
-    private autoTextEnabled;
-    private htmlContent?;
-    private htmlCharset;
-    private dateValue?;
-    private returnPathAddress?;
-    private senderAddress?;
-    private headers;
-    private attachments;
-    private replyToAddress?;
-    private priorityValue?;
-    private tagsValue;
-    private signer?;
-    private encrypter?;
-    private logger?;
-    private icalEventData?;
-    /**
-     * Sets the sender address.
-     * @param address The sender email address (string or EmailAddress object).
-     * @returns This instance for method chaining.
-     */
-    from(address: EmailAddress | string): this;
-    /**
-     * Sets the recipient address(es).
-     * @param address The recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    to(address: AddressInput): this;
-    /**
-     * Sets the CC recipient address(es).
-     * @param address The CC recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    cc(address: AddressInput): this;
-    /**
-     * Sets the BCC recipient address(es).
-     * @param address The BCC recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    bcc(address: AddressInput): this;
-    /**
-     * Sets the subject line for the email message.
-     * @param text The subject text to set.
-     * @returns This instance for method chaining.
-     */
-    subject(text: string): this;
-    /**
-     * Sets the plain text content of the email.
-     * @param content The plain text content to set.
-     * @param charset Optional charset for the text content (default: 'utf8').
-     * @returns This instance for method chaining.
-     */
-    text(content: string, charset?: string): this;
-    /**
-     * Sets the HTML content of the email.
-     * @param content The HTML content to set.
-     * @param charset Optional charset for the HTML content (default: 'utf8').
-     * @returns This instance for method chaining.
-     */
-    html(content: string, charset?: string): this;
-    /**
-     * Sets a custom email header.
-     * @param name The header name to set.
-     * @param value The header value to set.
-     * @returns This instance for method chaining.
-     */
-    header(name: string, value: string): this;
-    /**
-     * Sets multiple headers.
-     * Accepts both Record<string, string> and ImmutableHeaders.
-     * @param headers The headers to set (Record or ImmutableHeaders).
-     * @returns This instance for method chaining.
-     */
-    setHeaders(headers: EmailHeaders): this;
-    /**
-     * Attaches a file from path (reads file from filesystem).
-     * Similar to Laravel's attach() method.
-     * @param filePath The absolute or relative filesystem path to the file to attach.
-     * @param options Optional attachment configuration (filename, contentType, etc.).
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.attachFromPath('/path/to/file.pdf')
-     * message.attachFromPath('/path/to/file.pdf', { filename: 'custom-name.pdf' })
-     * ```
-     */
-    attachFromPath(filePath: string, options?: AttachmentOptions): Promise<this>;
-    /**
-     * Attaches raw data (string or Buffer).
-     * Similar to Laravel's attachData() method.
-     * @param content The content to attach (string or Buffer).
-     * @param options Attachment options including filename.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.attachData(Buffer.from('content'), 'file.txt')
-     * message.attachData('content', 'file.txt', { contentType: 'text/plain' })
-     * ```
-     */
-    attachData(content: string | Buffer, options: AttachmentDataOptions): this;
-    /**
-     * Embeds an inline attachment from file path (for images in HTML).
-     * Similar to Laravel's embed() method.
-     * Returns the Content-ID that can be used in HTML: &lt;img src="cid:{cid}">.
-     * @param filePath The path to the file to embed.
-     * @param options Optional attachment options (filename, contentType, etc.).
-     * @returns The Content-ID string that can be used in HTML.
-     * @example
-     * ```ts
-     * const cid = await message.embedFromPath('/path/to/logo.png')
-     * message.html(`<img src="cid:${cid}">`)
-     * ```
-     */
-    embedFromPath(filePath: string, options?: Omit<AttachmentOptions, "contentDisposition" | "cid">): Promise<string>;
-    /**
-     * Embeds raw data as inline attachment (for images in HTML).
-     * Similar to Laravel's embedData() method.
-     * Returns the Content-ID that can be used in HTML: &lt;img src="cid:{cid}">.
-     * @param content The content to embed (string or Buffer).
-     * @param filename The filename for the embedded attachment.
-     * @param options Optional attachment options (contentType, etc.).
-     * @returns The Content-ID string that can be used in HTML.
-     * @example
-     * ```ts
-     * const imageBuffer = Buffer.from('...')
-     * const cid = message.embedData(imageBuffer, 'logo.png', { contentType: 'image/png' })
-     * message.html(`<img src="cid:${cid}">`)
-     * ```
-     */
-    embedData(content: string | Buffer, filename: string, options?: Omit<AttachmentDataOptions, "filename" | "contentDisposition" | "cid">): string;
-    /**
-     * Sets the reply-to address.
-     * @param address The reply-to email address (string or EmailAddress object).
-     * @returns This instance for method chaining.
-     */
-    replyTo(address: EmailAddress | string): this;
-    /**
-     * Sets the date header for the email.
-     * @param date The date to set (Date object or ISO string).
-     * @returns This instance for method chaining.
-     */
-    date(date: Date | string): this;
-    /**
-     * Sets the return-path address (bounce address).
-     * @param address The return-path email address (string or EmailAddress object).
-     * @returns This instance for method chaining.
-     */
-    returnPath(address: EmailAddress | string): this;
-    /**
-     * Sets the sender address (different from From - used when From contains multiple addresses).
-     * @param address The sender email address (string or EmailAddress object).
-     * @returns This instance for method chaining.
-     */
-    sender(address: EmailAddress | string): this;
-    /**
-     * Adds recipient address(es) without replacing existing ones.
-     * @param address The recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    addTo(address: AddressInput): this;
-    /**
-     * Adds CC recipient address(es) without replacing existing ones.
-     * @param address The CC recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    addCc(address: AddressInput): this;
-    /**
-     * Adds BCC recipient address(es) without replacing existing ones.
-     * @param address The BCC recipient email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    addBcc(address: AddressInput): this;
-    /**
-     * Adds reply-to address(es) without replacing existing ones.
-     * @param address The reply-to email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    addReplyTo(address: EmailAddress | string | (EmailAddress | string)[]): this;
-    /**
-     * Adds from address(es) without replacing existing ones.
-     * @param address The sender email address(es) (string, EmailAddress, or arrays of either).
-     * @returns This instance for method chaining.
-     */
-    addFrom(address: EmailAddress | string | (EmailAddress | string)[]): this;
-    /**
-     * Sets the email priority.
-     * @param priority The priority level ('high', 'normal', or 'low').
-     * @returns This instance for method chaining.
-     */
-    priority(priority: Priority): this;
-    /**
-     * Sets email tags for categorization.
-     * @param tags The tags to set (string or array of strings).
-     * @returns This instance for method chaining.
-     */
-    tags(tags: string | string[]): this;
-    /**
-     * Signs the email message using a signer (DKIM or S/MIME).
-     * @param signer The signer instance to use.
-     * @example
-     * ```ts
-     * import { createDkimSigner } from '@visulima/email/crypto';
-     * const signer = createDkimSigner({
-     *   domainName: 'example.com',
-     *   keySelector: 'default',
-     *   privateKey: '-----BEGIN PRIVATE KEY-----...'
-     * });
-     * message.sign(signer)
-     * ```
-     */
-    sign(signer: EmailSigner): this;
-    /**
-     * Encrypts the email message using an encrypter (S/MIME).
-     * @param encrypter The encrypter instance to use.
-     * @example
-     * ```ts
-     * import { createSmimeEncrypter } from '@visulima/email/crypto';
-     * const encrypter = createSmimeEncrypter({
-     *   certificates: '/path/to/certificate.crt'
-     * });
-     * message.encrypt(encrypter)
-     * ```
-     */
-    encrypt(encrypter: EmailEncrypter): this;
-    /**
-     * Sets the logger instance for this message.
-     * @param logger The logger instance (Console) to use for logging.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.logger(console)
-     * ```
-     */
-    setLogger(logger: Console): this;
-    /**
-     * Attach a calendar event and define contents as string or function.
-     * @param contents The calendar content as a string or a function that receives an ICalCalendar instance.
-     * @param options Optional calendar event options (method, alternativeText).
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.icalEvent((calendar) => {
-     *   calendar.createEvent({
-     *     start: new Date(),
-     *     summary: 'Meeting'
-     *   });
-     * })
-     * message.icalEvent('BEGIN:VCALENDAR...')
-     * ```
-     */
-    icalEvent(contents: ((calendar: ICalCalendar) => void) | string, options?: CalendarEventOptions): this;
-    /**
-     * Attach a calendar event and load contents from a file.
-     * @param file The file path (string or URL) to load the calendar event from.
-     * @param options Optional calendar event options (method, alternativeText).
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.icalEventFromFile('/path/to/event.ics')
-     * message.icalEventFromFile(new URL('file:///path/to/event.ics'))
-     * ```
-     */
-    icalEventFromFile(file: string | URL, options?: CalendarEventOptions): this;
-    /**
-     * Attach a calendar event and load contents from a URL.
-     * @param url The URL to fetch the calendar event from.
-     * @param options Optional calendar event options (method, alternativeText).
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * message.icalEventFromUrl('https://example.com/event.ics')
-     * ```
-     */
-    icalEventFromUrl(url: string, options?: CalendarEventOptions): this;
-    /**
-     * Renders a template and sets as HTML content.
-     * Accepts a render function for flexible template engine support.
-     * @param render The template renderer function.
-     * @param template The template content (string, React component, etc.).
-     * @param data Optional data/variables to pass to the template.
-     * @param options Optional renderer-specific options.
-     * @param options.autoText Whether to auto-generate text version from HTML (default: true).
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * import { renderHandlebars } from '@visulima/email/template/handlebars';
-     * message.view(renderHandlebars, '<h1>Hello {{name}}!</h1>', { name: 'John' })
-     *
-     * import { renderMjml } from '@visulima/email/template/mjml';
-     * message.view(renderMjml, mjmlTemplate)
-     *
-     * import { renderReactEmail } from '@visulima/email/template/react-email';
-     * message.view(renderReactEmail, <WelcomeEmail name="John" />)
-     * ```
-     */
-    view(render: TemplateRenderer, template: unknown, data?: Record<string, unknown>, options?: {
-        [key: string]: unknown;
-        autoText?: boolean;
-    }): Promise<this>;
-    /**
-     * Renders a text template and sets as text content.
-     * @param render The template renderer function.
-     * @param template The text template content.
-     * @param data Optional data/variables to pass to the template.
-     * @param options Optional renderer-specific options.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * import { renderHandlebars } from '@visulima/email/template/handlebars';
-     * message.viewText(renderHandlebars, 'Hello {{name}}!', { name: 'John' })
-     * ```
-     */
-    viewText(render: TemplateRenderer, template: string, data?: Record<string, unknown>, options?: Record<string, unknown>): Promise<this>;
-    /**
-     * Builds the email options.
-     * @returns The built email options ready for sending.
-     * @throws {Error} When required fields (from, to, subject, content) are missing.
-     */
-    build(): Promise<EmailOptions>;
-    /**
-     * Gets the subject of the email.
-     * @returns The subject text or empty string if not set.
-     */
-    getSubject(): string;
-    /**
-     * Gets the from address.
-     * @returns The from address or undefined if not set.
-     */
-    getFrom(): EmailAddress | undefined;
-    /**
-     * Gets the recipient addresses.
-     * @returns Array of recipient addresses.
-     */
-    getTo(): EmailAddress[];
-    /**
-     * Gets the CC recipient addresses.
-     * @returns Array of CC recipient addresses.
-     */
-    getCc(): EmailAddress[];
-    /**
-     * Gets the BCC recipient addresses.
-     * @returns Array of BCC recipient addresses.
-     */
-    getBcc(): EmailAddress[];
-    /**
-     * Gets the reply-to address.
-     * @returns The reply-to address or undefined if not set.
-     */
-    getReplyTo(): EmailAddress | undefined;
-    /**
-     * Gets the sender address.
-     * @returns The sender address or undefined if not set.
-     */
-    getSender(): EmailAddress | undefined;
-    /**
-     * Gets the return-path address.
-     * @returns The return-path address or undefined if not set.
-     */
-    getReturnPath(): EmailAddress | undefined;
-    /**
-     * Gets the date header.
-     * @returns The date or undefined if not set.
-     */
-    getDate(): Date | undefined;
-    /**
-     * Gets the priority of the email.
-     * @returns The priority ('high', 'normal', 'low') or undefined if not set.
-     */
-    getPriority(): Priority | undefined;
-    /**
-     * Gets the plain text content.
-     * @returns The text content or undefined if not set.
-     */
-    getTextBody(): string | undefined;
-    /**
-     * Gets the charset for the text content.
-     * @returns The text charset (default: 'utf8').
-     */
-    getTextCharset(): string;
-    /**
-     * Gets the HTML content.
-     * @returns The HTML content or undefined if not set.
-     */
-    getHtmlBody(): string | undefined;
-    /**
-     * Gets the charset for the HTML content.
-     * @returns The HTML charset (default: 'utf8').
-     */
-    getHtmlCharset(): string;
-    /**
-     * Gets the attachments.
-     * @returns Array of attachments.
-     */
-    getAttachments(): Attachment[];
-    /**
-     * Attempts to auto-generate text content from HTML.
-     * @param html The HTML content to convert.
-     * @private
-     */
-    private tryAutoGenerateText;
-    /**
-     * Creates an error, logs it, and throws it.
-     * @param message Error message to throw.
-     * @param logMessage Optional log message (defaults to message).
-     * @private
-     */
-    private throwAndLogError;
-}
-export default MailMessage;

package/dist/mail.d.ts

@@ -1,206 +0,0 @@
-import DraftMailMessage from "./draft-mail-message.d.ts";
-import MailMessage from "./mail-message.d.ts";
-import type { Provider } from "./providers/provider.d.ts";
-import type { EmailAddress, EmailHeaders, EmailOptions, EmailResult, Receipt, Result } from "./types.d.ts";
-/**
- * Type alias for messages that can be sent via Mail.send().
- */
-export type SendableMessage = MailMessage | EmailOptions;
-/**
- * Global email configuration that applies to all emails sent through a Mail instance.
- */
-export interface MailGlobalConfig {
-    /**
-     * Default from address to use if not specified in the message.
-     */
-    from?: EmailAddress;
-    /**
-     * Global headers to add to all emails.
-     * These will be merged with message-specific headers, with message headers taking precedence.
-     */
-    headers?: EmailHeaders;
-    /**
-     * Default reply-to address to use if not specified in the message.
-     */
-    replyTo?: EmailAddress;
-}
-/**
- * Mail class - instance-based email sending.
- */
-export declare class Mail {
-    /**
-     * Extracts error messages from an error object.
-     * @param error Error object to extract messages from.
-     * @returns Array of error messages.
-     * @private
-     */
-    private static extractErrorMessages;
-    private provider;
-    private logger?;
-    private loggerInstance?;
-    private globalConfig?;
-    /**
-     * Creates a new Mail instance with a provider.
-     * @param provider The email provider instance.
-     */
-    constructor(provider: Provider);
-    /**
-     * Sets the logger instance for this mail instance.
-     * @param logger The logger instance (Console) to use for logging.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * const mail = createMail(provider);
-     * mail.setLogger(console);
-     * ```
-     */
-    setLogger(logger: Console): this;
-    /**
-     * Sets the default from address for all emails sent through this Mail instance.
-     * @param from Default from address to use if not specified in the message.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * const mail = createMail(provider);
-     * mail.setFrom({ email: "noreply@example.com", name: "My App" });
-     * ```
-     */
-    setFrom(from: EmailAddress): this;
-    /**
-     * Sets the default reply-to address for all emails sent through this Mail instance.
-     * @param replyTo Default reply-to address to use if not specified in the message.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * const mail = createMail(provider);
-     * mail.setReplyTo({ email: "support@example.com" });
-     * ```
-     */
-    setReplyTo(replyTo: EmailAddress): this;
-    /**
-     * Sets default headers for all emails sent through this Mail instance.
-     * These headers will be merged with message-specific headers, with message headers taking precedence.
-     * @param headers Default headers to add to all emails.
-     * @returns This instance for method chaining.
-     * @example
-     * ```ts
-     * const mail = createMail(provider);
-     * mail.setHeaders({ "X-App-Name": "MyApp", "X-Version": "1.0.0" });
-     * ```
-     */
-    setHeaders(headers: EmailHeaders): this;
-    /**
-     * Creates a draft email in EML (RFC 822) format without sending it.
-     * This is useful for previewing, saving for later, or testing email content.
-     * @param message The message to create a draft from (MailMessage or EmailOptions).
-     * @returns The email in EML (RFC 822) format as a string with X-Unsent: 1 header.
-     * @example
-     * ```ts
-     * // Create a draft from MailMessage
-     * const message = new MailMessage()
-     *   .to("user@example.com")
-     *   .from("sender@example.com")
-     *   .subject("Hello")
-     *   .html("<h1>Hello World</h1>");
-     *
-     * const eml = await mail.draft(message);
-     * console.log("Draft EML:", eml);
-     *
-     * // Save to file
-     * await fs.writeFile("draft.eml", eml);
-     *
-     * // Or send later by parsing the EML back to EmailOptions
-     * ```
-     */
-    draft(message: SendableMessage | DraftMailMessage): Promise<string>;
-    /**
-     * Sends an email message or email options.
-     * @param message The message to send (MailMessage or EmailOptions).
-     * @returns A result object containing the email result or error.
-     * @example
-     * ```ts
-     * // Using MailMessage
-     * const message = new MailMessage()
-     *   .to("user@example.com")
-     *   .from("sender@example.com")
-     *   .subject("Hello")
-     *   .html("<h1>Hello World</h1>");
-     * await mail.send(message);
-     *
-     * // Using EmailOptions
-     * await mail.send({
-     *   to: "user@example.com",
-     *   from: "sender@example.com",
-     *   subject: "Hello",
-     *   html: "<h1>Hello World</h1>"
-     * });
-     * ```
-     */
-    send(message: SendableMessage): Promise<Result<EmailResult>>;
-    /**
-     * Sends multiple messages using the email service.
-     * Returns an async iterable that yields receipts for each sent message.
-     * @example
-     * ```ts
-     * const messages = [
-     *   { from: "sender@example.com", to: "user1@example.com", subject: "Hello 1", html: "<h1>Hello</h1>" },
-     *   { from: "sender@example.com", to: "user2@example.com", subject: "Hello 2", html: "<h1>Hello</h1>" },
-     * ];
-     *
-     * for await (const receipt of mail.sendMany(messages)) {
-     *   if (receipt.successful) {
-     *     console.log("Sent:", receipt.messageId);
-     *   } else {
-     *     console.error("Failed:", receipt.errorMessages);
-     *   }
-     * }
-     * ```
-     * @param messages An iterable of MailMessage instances or email options to send.
-     * @param options Optional parameters for sending.
-     * @param options.signal Abort signal to cancel the operation.
-     * @returns An async iterable that yields receipts for each sent message.
-     */
-    sendMany(messages: Iterable<SendableMessage> | AsyncIterable<SendableMessage>, options?: {
-        signal?: AbortSignal;
-    }): AsyncIterable<Receipt>;
-    /**
-     * Builds email options from a MailMessage instance for draft creation.
-     * Applies global configuration before building to ensure required fields are set.
-     * @param message The MailMessage or DraftMailMessage instance.
-     * @returns Built email options.
-     * @private
-     */
-    private buildDraftFromMessage;
-    /**
-     * Builds email options from EmailOptions for draft creation.
-     * @param options The EmailOptions object.
-     * @returns Email options.
-     * @private
-     */
-    private buildDraftFromOptions;
-    /**
-     * Applies global configuration to a MailMessage instance.
-     * @param message The MailMessage or DraftMailMessage instance.
-     * @private
-     */
-    private applyGlobalConfigToMessage;
-    /**
-     * Applies global configuration to email options.
-     * Global values are only applied if the corresponding field is not already set in the email options.
-     * @param emailOptions The email options to apply global configuration to.
-     * @returns Email options with global configuration applied.
-     * @private
-     */
-    private applyGlobalConfig;
-}
-/**
- * Creates a new Mail instance with a provider.
- * @param provider The email provider instance.
- * @returns A new Mail instance.
- * @example
- * ```ts
- * const mail = createMail(provider);
- * mail.setFrom({ email: "noreply@example.com", name: "My App" });
- * ```
- */
-export declare const createMail: (provider: Provider) => Mail;

package/dist/packem_shared/Mail-6Bltpy_p.js

@@ -1 +0,0 @@
-var b=Object.defineProperty;var l=(o,e)=>b(o,"name",{value:e,configurable:!0});import{MailMessage as f}from"./MailMessage-B76GPBBA.js";import{z as p}from"./build-mime-message-IYaUqqPJ.js";import{c as m}from"./create-logger-BiWdqFNg.js";import{i as n}from"./headers-to-record-Qo124ImV.js";var y=Object.defineProperty,C=l((o,e)=>y(o,"name",{value:e,configurable:!0}),"s");class h extends f{static{l(this,"DraftMailMessage")}static{C(this,"DraftMailMessage")}constructor(){super(),this.header("X-Unsent","1")}}var M=Object.defineProperty,c=l((o,e)=>M(o,"name",{value:e,configurable:!0}),"n");const v=c((o,e,s)=>{e.success&&e.data?o&&o.info("Email sent successfully",{messageId:e.data.messageId,provider:e.data.provider}):o&&o.error("Email send failed",{error:e.error,provider:s})},"logSendResult");class d{static{l(this,"Mail")}static{c(this,"Mail")}static extractErrorMessages(e){return e instanceof Error?[e.message]:[String(e||"Unknown error")]}provider;logger;loggerInstance;globalConfig;constructor(e){this.provider=e}setLogger(e){return this.loggerInstance=e,this.logger=m("Mail",e),this}setFrom(e){return this.globalConfig||(this.globalConfig={}),this.globalConfig.from=e,this.logger&&this.logger.debug("Default from address updated",{from:e.email}),this}setReplyTo(e){return this.globalConfig||(this.globalConfig={}),this.globalConfig.replyTo=e,this.logger&&this.logger.debug("Default reply-to address updated",{replyTo:e.email}),this}setHeaders(e){if(this.globalConfig||(this.globalConfig={}),this.globalConfig.headers=e,this.logger){const s=n(e);this.logger.debug("Default headers updated",{count:Object.keys(s).length,headers:Object.keys(s)})}return this}async draft(e){let s=e instanceof f||e instanceof h?await this.buildDraftFromMessage(e):await this.buildDraftFromOptions(e);s=this.applyGlobalConfig(s);const t=s.headers?n(s.headers):{};s.headers={...t,"X-Unsent":"1"};const r=await p(s);return this.logger&&this.logger.debug("Draft created successfully in EML format",{from:s.from.email,size:r.length,subject:s.subject,to:Array.isArray(s.to)?s.to.length:1}),r}async send(e){if(e instanceof h)throw new TypeError("Cannot send draft messages. Convert to MailMessage first or remove X-Unsent header.");let s;if(e instanceof f)this.logger&&this.logger.debug("Sending MailMessage instance"),this.loggerInstance&&e.setLogger(this.loggerInstance),s=await e.build();else{const r=e;this.logger&&this.logger.debug("Sending email with options",{subject:r.subject,to:Array.isArray(r.to)?r.to.length:1}),s=r}s=this.applyGlobalConfig(s);const t=await this.provider.sendEmail(s);return v(this.logger,t,this.provider.name||"unknown"),t}async*sendMany(e,s){const t=this.provider.name;let r=0,g=0,i=0;this.logger&&this.logger.debug("Starting batch email send",{provider:t});for await(const u of e){if(u instanceof h)throw new TypeError("Cannot send draft messages. Convert to MailMessage first or remove X-Unsent header.");if(s?.signal?.aborted){this.logger&&this.logger.warn("Batch send operation was aborted",{failed:i,processed:r,successful:g}),yield{errorMessages:["Send operation was aborted"],provider:t,successful:!1};return}r+=1;try{const a=await this.send(u);a.success&&a.data?(g+=1,this.logger&&this.logger.debug(`Email ${r} sent successfully`,{messageId:a.data.messageId}),yield{messageId:a.data.messageId,provider:a.data.provider||t,response:a.data.response,successful:!0,timestamp:a.data.timestamp}):(i+=1,this.logger&&this.logger.error(`Email ${r} send failed`,{error:a.error}),yield{errorMessages:d.extractErrorMessages(a.error),provider:t,successful:!1})}catch(a){i+=1,this.logger&&this.logger.error(`Email ${r} send failed with exception`,a),yield{errorMessages:d.extractErrorMessages(a),provider:t,successful:!1}}}this.logger&&this.logger.debug("Batch email send completed",{failureCount:i,processedCount:r,provider:t,successCount:g})}async buildDraftFromMessage(e){return this.logger&&this.logger.debug("Creating draft from MailMessage instance"),this.loggerInstance&&e.setLogger(this.loggerInstance),this.applyGlobalConfigToMessage(e),await e.build()}async buildDraftFromOptions(e){return this.logger&&this.logger.debug("Creating draft from email options",{subject:e.subject,to:Array.isArray(e.to)?e.to.length:1}),e}applyGlobalConfigToMessage(e){const s=this.globalConfig?.from;s&&!e.getFrom()&&e.from(s);const t=this.globalConfig?.replyTo;if(t&&!e.getReplyTo()&&e.replyTo(t),this.globalConfig?.headers){const r=n(this.globalConfig.headers);Object.entries(r).forEach(([g,i])=>{e.header(g,i)})}}applyGlobalConfig(e){if(!this.globalConfig)return e;const s={...e};if(!s.from&&this.globalConfig.from&&(s.from=this.globalConfig.from,this.logger&&this.logger.debug("Applied global from address",{from:this.globalConfig.from.email})),!s.replyTo&&this.globalConfig.replyTo&&(s.replyTo=this.globalConfig.replyTo,this.logger&&this.logger.debug("Applied global reply-to address",{replyTo:this.globalConfig.replyTo.email})),this.globalConfig.headers){const t=n(this.globalConfig.headers),r=s.headers?n(s.headers):{};s.headers={...t,...r},this.logger&&this.logger.debug("Merged global headers",{globalCount:Object.keys(t).length,messageCount:Object.keys(r).length})}return s}}const D=c(o=>new d(o),"createMail");export{d as Mail,D as createMail};

package/dist/packem_shared/MailMessage-B76GPBBA.js

@@ -1 +0,0 @@
-var A=Object.defineProperty;var d=(n,e)=>A(n,"name",{value:e,configurable:!0});import{createRequire as b}from"node:module";import C from"ical-generator";import{readFileAsBuffer as u,detectMimeType as g,generateContentId as m}from"./detectMimeType-S8WRsNtY.js";import p from"../template-engines/html-to-text.js";import{c as E}from"./create-logger-BiWdqFNg.js";import{i as l}from"./headers-to-record-Qo124ImV.js";const T=b(import.meta.url),a=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,f=d(n=>{if(typeof a<"u"&&a.versions&&a.versions.node){const[e,t]=a.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return a.getBuiltinModule(n)}return T(n)},"__cjs_getBuiltinModule"),{basename:c}=f("node:path"),{fileURLToPath:x}=f("node:url");var w=Object.defineProperty,y=d((n,e)=>w(n,"name",{value:e,configurable:!0}),"l");const o=y(n=>Array.isArray(n)?n.map(e=>typeof e=="string"?{email:e}:e):typeof n=="string"?[{email:n}]:[n],"normalizeAddresses");class M{static{d(this,"MailMessage")}static{y(this,"MailMessage")}fromAddress;toAddresses=[];ccAddresses=[];bccAddresses=[];subjectText="";textContent;textCharset="utf8";autoTextEnabled=!0;htmlContent;htmlCharset="utf8";dateValue;returnPathAddress;senderAddress;headers={};attachments=[];replyToAddress;priorityValue;tagsValue=[];signer;encrypter;logger;icalEventData;from(e){return this.fromAddress=typeof e=="string"?{email:e}:e,this}to(e){return this.toAddresses.length=0,this.toAddresses.push(...o(e)),this}cc(e){return this.ccAddresses.length=0,this.ccAddresses.push(...o(e)),this}bcc(e){return this.bccAddresses.length=0,this.bccAddresses.push(...o(e)),this}subject(e){return this.subjectText=e,this}text(e,t="utf8"){return this.textContent=e,this.textCharset=t,this}html(e,t="utf8"){return this.htmlContent=e,this.htmlCharset=t,this}header(e,t){return this.headers[e]=t,this}setHeaders(e){const t=l(e);return Object.assign(this.headers,t),this}async attachFromPath(e,t){try{const s=await u(e),i=t?.filename||c(e)||"attachment",r=t?.contentType||g(i);this.attachments.push({cid:t?.cid,content:s,contentDisposition:t?.contentDisposition||"attachment",contentType:r,encoding:t?.encoding,filename:i,headers:t?.headers}),this.logger&&this.logger.debug(`Attachment added from path: ${e}`,{contentType:r,filename:i})}catch(s){throw this.logger&&this.logger.error(`Failed to attach file from path: ${e}`,s),s}return this}attachData(e,t){const s=t.contentType||g(t.filename);return this.attachments.push({cid:t.cid,content:e,contentDisposition:t.contentDisposition||"attachment",contentType:s,encoding:t.encoding,filename:t.filename,headers:t.headers}),this.logger&&this.logger.debug("Attachment added from data",{contentType:s,filename:t.filename}),this}async embedFromPath(e,t){try{const s=await u(e),i=t?.filename||c(e)||"inline",r=t?.contentType||g(i),h=m(i);return this.attachments.push({cid:h,content:s,contentDisposition:"inline",contentType:r,filename:i}),this.logger&&this.logger.debug(`Inline attachment embedded from path: ${e}`,{cid:h,contentType:r,filename:i}),h}catch(s){throw this.logger&&this.logger.error(`Failed to embed file from path: ${e}`,s),s}}embedData(e,t,s){const i=s?.contentType||g(t),r=m(t);return this.attachments.push({cid:r,content:e,contentDisposition:"inline",contentType:i,filename:t}),this.logger&&this.logger.debug("Inline attachment embedded from data",{cid:r,contentType:i,filename:t}),r}replyTo(e){return this.replyToAddress=typeof e=="string"?{email:e}:e,this}date(e){return this.dateValue=typeof e=="string"?new Date(e):e,this.logger&&this.logger.debug("Date header set",{date:this.dateValue.toISOString()}),this}returnPath(e){return this.returnPathAddress=typeof e=="string"?{email:e}:e,this.logger&&this.logger.debug("Return-path address set",{returnPath:this.returnPathAddress.email}),this}sender(e){return this.senderAddress=typeof e=="string"?{email:e}:e,this.logger&&this.logger.debug("Sender address set",{sender:this.senderAddress.email}),this}addTo(e){return this.toAddresses.push(...o(e)),this}addCc(e){return this.ccAddresses.push(...o(e)),this}addBcc(e){return this.bccAddresses.push(...o(e)),this}addReplyTo(e){const t=Array.isArray(e)?e:[e];if(t.length>0){const s=t[0];this.replyToAddress=typeof s=="string"?{email:s}:s}return this}addFrom(e){const t=Array.isArray(e)?e:[e];if(t.length>0){const s=t[0];this.fromAddress=typeof s=="string"?{email:s}:s}return this}priority(e){return this.priorityValue=e,this}tags(e){return this.tagsValue=Array.isArray(e)?e:[e],this}sign(e){return this.signer=e,this.logger&&this.logger.debug("Email signer configured"),this}encrypt(e){return this.encrypter=e,this.logger&&this.logger.debug("Email encrypter configured"),this}setLogger(e){return this.logger=E("MailMessage",e),this}icalEvent(e,t){if(typeof e=="function"){const s=C();e(s),this.icalEventData={content:s.toString(),...t}}else this.icalEventData={content:e,...t};return this.logger&&this.logger.debug("Calendar event attached",{method:t?.method}),this}icalEventFromFile(e,t){const s=typeof e=="string"?e:x(e);return this.icalEventData={path:s,...t},this.logger&&this.logger.debug(`Calendar event attached from file: ${s}`,{method:t?.method}),this}icalEventFromUrl(e,t){return this.icalEventData={href:e,...t},this.logger&&this.logger.debug(`Calendar event attached from URL: ${e}`,{method:t?.method}),this}async view(e,t,s,i){try{const r=i?.autoText!==!1;this.autoTextEnabled=r,this.logger&&this.logger.debug("Rendering template",{autoText:r});const h=await e(t,s,i);this.html(h),r&&h&&this.tryAutoGenerateText(h),this.logger&&this.logger.debug("Template rendered successfully")}catch(r){throw this.logger&&this.logger.error("Failed to render template",r),new Error(`Failed to render template: ${r.message}`)}return this}async viewText(e,t,s,i){try{this.logger&&this.logger.debug("Rendering text template");const r=await e(t,s,i);if(typeof r=="string")this.text(r),this.logger&&this.logger.debug("Text template rendered successfully");else throw new TypeError("Text renderer must return a string")}catch(r){throw this.logger&&this.logger.error("Failed to render text template",r),new Error(`Failed to render text template: ${r.message}`)}return this}async build(){if(this.logger&&this.logger.debug("Building email message"),this.fromAddress||this.throwAndLogError("From address is required","Build failed: from address is required"),this.toAddresses.length===0&&this.throwAndLogError("At least one recipient is required","Build failed: at least one recipient is required"),this.subjectText||this.throwAndLogError("Subject is required","Build failed: subject is required"),this.htmlContent&&!this.textContent&&this.autoTextEnabled)try{this.textContent=p(this.htmlContent),this.logger&&this.logger.debug("Auto-generated text content from HTML")}catch{this.logger&&this.logger.debug("Failed to convert HTML to text; proceeding without text content.")}!this.textContent&&!this.htmlContent&&this.throwAndLogError("Either text or html content is required","Build failed: either text or html content is required");let e={from:this.fromAddress,html:this.htmlContent,subject:this.subjectText,text:this.textContent,to:this.toAddresses.length===1?this.toAddresses[0]:this.toAddresses};return this.ccAddresses.length>0&&(e.cc=this.ccAddresses.length===1?this.ccAddresses[0]:this.ccAddresses),this.bccAddresses.length>0&&(e.bcc=this.bccAddresses.length===1?this.bccAddresses[0]:this.bccAddresses),Object.keys(this.headers).length>0&&(e.headers=this.headers),this.attachments.length>0&&(e.attachments=this.attachments,this.logger&&this.logger.debug(`Email includes ${this.attachments.length} attachment(s)`)),this.replyToAddress&&(e.replyTo=this.replyToAddress),this.priorityValue&&(e.priority=this.priorityValue),this.tagsValue.length>0&&(e.tags=this.tagsValue),this.icalEventData&&(e.icalEvent=this.icalEventData,this.logger&&this.logger.debug("Email includes calendar event")),this.dateValue&&(e.headers={...l(e.headers||{}),Date:this.dateValue.toUTCString()}),this.returnPathAddress&&(e.headers={...l(e.headers||{}),"Return-Path":this.returnPathAddress.email}),this.senderAddress&&(e.headers={...l(e.headers||{}),Sender:this.senderAddress.email}),this.signer&&(this.logger&&this.logger.debug("Signing email message"),e=await this.signer.sign(e),this.logger&&this.logger.debug("Email message signed successfully")),this.encrypter&&(this.logger&&this.logger.debug("Encrypting email message"),e=await this.encrypter.encrypt(e),this.logger&&this.logger.debug("Email message encrypted successfully")),this.logger&&this.logger.debug("Email message built successfully",{bcc:this.bccAddresses.length,cc:this.ccAddresses.length,hasHtml:!!this.htmlContent,hasText:!!this.textContent,to:this.toAddresses.length}),e}getSubject(){return this.subjectText}getFrom(){return this.fromAddress}getTo(){return[...this.toAddresses]}getCc(){return[...this.ccAddresses]}getBcc(){return[...this.bccAddresses]}getReplyTo(){return this.replyToAddress}getSender(){return this.senderAddress}getReturnPath(){return this.returnPathAddress}getDate(){return this.dateValue}getPriority(){return this.priorityValue}getTextBody(){return this.textContent}getTextCharset(){return this.textCharset}getHtmlBody(){return this.htmlContent}getHtmlCharset(){return this.htmlCharset}getAttachments(){return[...this.attachments]}tryAutoGenerateText(e){try{const t=p(e);t&&!this.textContent&&this.text(t),this.logger&&this.logger.debug("Auto-generated text content from HTML template")}catch(t){this.logger&&this.logger.warn("Failed to auto-generate text from HTML template",t)}}throwAndLogError(e,t){const s=new Error(e);throw this.logger&&this.logger.error(t||e),s}}export{M as MailMessage,M as default};