@visulima/email 1.0.0-alpha.16 → 1.0.0-alpha.18

package/dist/utils/format-email-address.d.ts

@@ -1,9 +1,10 @@
-import type { EmailAddress } from "../types.d.ts";
+import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
 /**
- * Formats an email address as "Name <email@example.com>" or just "email@example.com" if no name is provided.
- * @param address The email address object to format.
- * @returns The formatted email address string in RFC 5322 format.
- * @throws {EmailError} When the email address is invalid.
- */
+* Formats an email address as "Name <email@example.com>" or just "email@example.com" if no name is provided.
+* @param address The email address object to format.
+* @returns The formatted email address string in RFC 5322 format.
+* @throws {EmailError} When the email address is invalid.
+*/
 declare const formatEmailAddress: (address: EmailAddress) => string;
-export default formatEmailAddress;
+export { formatEmailAddress as default };

package/dist/utils/normalize-email-aliases.d.ts

@@ -1,22 +1,22 @@
 /**
- * Normalizes email aliases for supported email providers.
- * For example: example@gmail.com and example+another@gmail.com point to the same email address.
- * This function normalizes aliases to their canonical form.
- *
- * Supported providers:
- * - Gmail: Removes dots and plus aliases (example+test@gmail.com → example@gmail.com)
- * - Yahoo, Outlook, Hotmail, Live, MSN, iCloud, ProtonMail, Zoho, FastMail, Mail.com, GMX: Removes plus aliases only
- * @param email The email address to normalize.
- * @returns The normalized email address, or the original email if not supported or invalid.
- * @example
- * ```ts
- * import { normalizeEmailAliases } from "@visulima/email/utils/normalize-email-aliases";
- *
- * normalizeEmailAliases("example+test@gmail.com"); // "example@gmail.com"
- * normalizeEmailAliases("ex.ample@gmail.com"); // "example@gmail.com"
- * normalizeEmailAliases("user+tag@yahoo.com"); // "user@yahoo.com"
- * normalizeEmailAliases("user@example.com"); // "user@example.com" (unchanged)
- * ```
- */
+* Normalizes email aliases for supported email providers.
+* For example: example@gmail.com and example+another@gmail.com point to the same email address.
+* This function normalizes aliases to their canonical form.
+*
+* Supported providers:
+* - Gmail: Removes dots and plus aliases (example+test@gmail.com → example@gmail.com)
+* - Yahoo, Outlook, Hotmail, Live, MSN, iCloud, ProtonMail, Zoho, FastMail, Mail.com, GMX: Removes plus aliases only
+* @param email The email address to normalize.
+* @returns The normalized email address, or the original email if not supported or invalid.
+* @example
+* ```ts
+* import { normalizeEmailAliases } from "@visulima/email/utils/normalize-email-aliases";
+*
+* normalizeEmailAliases("example+test@gmail.com"); // "example@gmail.com"
+* normalizeEmailAliases("ex.ample@gmail.com"); // "example@gmail.com"
+* normalizeEmailAliases("user+tag@yahoo.com"); // "user@yahoo.com"
+* normalizeEmailAliases("user@example.com"); // "user@example.com" (unchanged)
+* ```
+*/
 declare const normalizeEmailAliases: (email: string) => string;
-export default normalizeEmailAliases;
+export { normalizeEmailAliases as default };

package/dist/utils/parse-address.d.ts

@@ -1,19 +1,20 @@
-import type { EmailAddress } from "../types.d.ts";
+import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
 /**
- * Parses a string representation of an email address into an EmailAddress object.
- * Supports formats: "email@example.com", "Name <email@example.com>", "<email@example.com>".
- * @example Parsing an address with a name
- * ```ts
- * const address = parseAddress("John Doe <john@example.com>");
- * // { name: "John Doe", email: "john@example.com" }
- * ```
- * @example Parsing an address without a name
- * ```ts
- * const address = parseAddress("jane@example.com");
- * // { email: "jane@example.com" }
- * ```
- * @param address The string representation of the address to parse.
- * @returns An EmailAddress object if parsing is successful, or undefined if invalid.
- */
+* Parses a string representation of an email address into an EmailAddress object.
+* Supports formats: "email@example.com", "Name &lt;email@example.com>", "&lt;email@example.com>".
+* @example Parsing an address with a name
+* ```ts
+* const address = parseAddress("John Doe <john@example.com>");
+* // { name: "John Doe", email: "john@example.com" }
+* ```
+* @example Parsing an address without a name
+* ```ts
+* const address = parseAddress("jane@example.com");
+* // { email: "jane@example.com" }
+* ```
+* @param address The string representation of the address to parse.
+* @returns An EmailAddress object if parsing is successful, or undefined if invalid.
+*/
 declare const parseAddress: (address: string) => EmailAddress | undefined;
-export default parseAddress;
+export { parseAddress as default };

package/dist/utils/validation/check-mx-records.d.ts

@@ -1,42 +1,43 @@
-import type { Cache } from "../cache.d.ts";
-export type { Cache, InMemoryCache } from "../cache.d.ts";
+import { Cache } from "../cache.js";
+export { type InMemoryCache } from "../cache.js";
 /**
- * MX record information.
- */
-export interface MxRecord {
-    exchange: string;
-    priority: number;
+* MX record information.
+*/
+interface MxRecord {
+  exchange: string;
+  priority: number;
 }
 /**
- * Result of MX record check.
- */
-export interface MxCheckResult {
-    error?: string;
-    records?: MxRecord[];
-    valid: boolean;
+* Result of MX record check.
+*/
+interface MxCheckResult {
+  error?: string;
+  records?: MxRecord[];
+  valid: boolean;
 }
 /**
- * Options for MX record checking.
- */
-export interface MxCheckOptions {
-    cache?: Cache<MxCheckResult>;
-    ttl?: number;
+* Options for MX record checking.
+*/
+interface MxCheckOptions {
+  cache?: Cache<MxCheckResult>;
+  ttl?: number;
 }
 /**
- * Checks MX records for a domain.
- * @param domain The domain to check MX records for.
- * @param options Options for MX record checking, including caching.
- * @returns Result containing MX records or error.
- * @example
- * ```ts
- * import { checkMxRecords } from "@visulima/email/validation/check-mx-records";
- * import { InMemoryCache } from "@visulima/email/utils/cache";
- *
- * const cache = new InMemoryCache();
- * const result = await checkMxRecords("example.com", { cache });
- * if (result.valid) {
- *     console.log("MX records:", result.records);
- * }
- * ```
- */
-export declare const checkMxRecords: (domain: string, options?: MxCheckOptions) => Promise<MxCheckResult>;
+* Checks MX records for a domain.
+* @param domain The domain to check MX records for.
+* @param options Options for MX record checking, including caching.
+* @returns Result containing MX records or error.
+* @example
+* ```ts
+* import { checkMxRecords } from "@visulima/email/validation/check-mx-records";
+* import { InMemoryCache } from "@visulima/email/utils/cache";
+*
+* const cache = new InMemoryCache();
+* const result = await checkMxRecords("example.com", { cache });
+* if (result.valid) {
+*     console.log("MX records:", result.records);
+* }
+* ```
+*/
+declare const checkMxRecords: (domain: string, options?: MxCheckOptions) => Promise<MxCheckResult>;
+export { type Cache, MxCheckOptions, MxCheckResult, MxRecord, checkMxRecords };

package/dist/utils/validation/disposable-email-domains.d.ts

@@ -1,13 +1 @@
-/**
- * Re-exports all functionality from @visulima/disposable-email-domains.
- * This provides access to disposable email domain checking utilities.
- * @example
- * ```ts
- * import { isDisposableEmail, isDisposableDomain, getDomainList } from "\@visulima/email/validation/disposable-email-domains";
- *
- * if (isDisposableEmail("user@mailinator.com")) {
- *     console.log("Disposable email detected!");
- * }
- * ```
- */
-export * from "@visulima/disposable-email-domains";
+export * from '@visulima/disposable-email-domains';

package/dist/utils/validation/role-accounts.d.ts

@@ -1,21 +1,21 @@
 /**
- * Common role account prefixes that indicate non-personal email addresses.
- * Includes RFC 2142 standard role accounts and common business/operational prefixes.
- */
+* Common role account prefixes that indicate non-personal email addresses.
+* Includes RFC 2142 standard role accounts and common business/operational prefixes.
+*/
 declare const ROLE_ACCOUNT_PREFIXES: Set<string>;
 /**
- * Checks if an email address is a role account (non-personal).
- * @param email The email address to check.
- * @param customPrefixes Optional set of additional role account prefixes.
- * @returns True if the email is a role account, false otherwise.
- * @example
- * ```ts
- * import { isRoleAccount } from "@visulima/email/validation/role-accounts";
- *
- * if (isRoleAccount("noreply@example.com")) {
- *     console.log("This is a role account");
- * }
- * ```
- */
-export declare const isRoleAccount: (email: string, customPrefixes?: Set<string>) => boolean;
-export { ROLE_ACCOUNT_PREFIXES };
+* Checks if an email address is a role account (non-personal).
+* @param email The email address to check.
+* @param customPrefixes Optional set of additional role account prefixes.
+* @returns True if the email is a role account, false otherwise.
+* @example
+* ```ts
+* import { isRoleAccount } from "@visulima/email/validation/role-accounts";
+*
+* if (isRoleAccount("noreply@example.com")) {
+*     console.log("This is a role account");
+* }
+* ```
+*/
+declare const isRoleAccount: (email: string, customPrefixes?: Set<string>) => boolean;
+export { ROLE_ACCOUNT_PREFIXES, isRoleAccount };

package/dist/utils/validation/validate-email.d.ts

@@ -1,7 +1,7 @@
 /**
- * Validates an email address format according to basic RFC standards.
- * @param email The email address string to validate.
- * @returns True if the email address is valid, false otherwise.
- */
+* Validates an email address format according to basic RFC standards.
+* @param email The email address string to validate.
+* @returns True if the email address is valid, false otherwise.
+*/
 declare const validateEmail: (email: string) => boolean;
-export default validateEmail;
+export { validateEmail as default };

package/dist/utils/validation/verify-email.d.ts

@@ -1,47 +1,50 @@
-import type { SmtpVerificationOptions } from "./verify-smtp.d.ts";
+import { SmtpVerificationOptions } from "./verify-smtp.js";
+import "../cache.js";
+import "./check-mx-records.js";
 /**
- * Options for comprehensive email verification.
- */
-export interface EmailVerificationOptions extends SmtpVerificationOptions {
-    checkDisposable?: boolean;
-    checkMx?: boolean;
-    checkRoleAccount?: boolean;
-    checkSmtp?: boolean;
-    customDisposableDomains?: Set<string>;
-    customRolePrefixes?: Set<string>;
+* Options for comprehensive email verification.
+*/
+interface EmailVerificationOptions extends SmtpVerificationOptions {
+  checkDisposable?: boolean;
+  checkMx?: boolean;
+  checkRoleAccount?: boolean;
+  checkSmtp?: boolean;
+  customDisposableDomains?: Set<string>;
+  customRolePrefixes?: Set<string>;
 }
 /**
- * Result of comprehensive email verification.
- */
-export interface EmailVerificationResult {
-    disposable?: boolean;
-    errors: string[];
-    formatValid: boolean;
-    mxValid?: boolean;
-    roleAccount?: boolean;
-    smtpValid?: boolean;
-    valid: boolean;
-    warnings: string[];
+* Result of comprehensive email verification.
+*/
+interface EmailVerificationResult {
+  disposable?: boolean;
+  errors: string[];
+  formatValid: boolean;
+  mxValid?: boolean;
+  roleAccount?: boolean;
+  smtpValid?: boolean;
+  valid: boolean;
+  warnings: string[];
 }
 /**
- * Comprehensive email verification combining multiple checks.
- * @param email The email address to verify.
- * @param options Verification options.
- * @returns Detailed verification result.
- * @example
- * ```ts
- * import { verifyEmail } from "@visulima/email/validation/verify-email";
- *
- * const result = await verifyEmail("user@example.com", {
- *     checkDisposable: true,
- *     checkRoleAccount: true,
- *     checkMx: true,
- *     checkSmtp: false
- * });
- *
- * if (result.valid) {
- *     console.log("Email is valid!");
- * }
- * ```
- */
-export declare const verifyEmail: (email: string, options?: EmailVerificationOptions) => Promise<EmailVerificationResult>;
+* Comprehensive email verification combining multiple checks.
+* @param email The email address to verify.
+* @param options Verification options.
+* @returns Detailed verification result.
+* @example
+* ```ts
+* import { verifyEmail } from "@visulima/email/validation/verify-email";
+*
+* const result = await verifyEmail("user@example.com", {
+*     checkDisposable: true,
+*     checkRoleAccount: true,
+*     checkMx: true,
+*     checkSmtp: false
+* });
+*
+* if (result.valid) {
+*     console.log("Email is valid!");
+* }
+* ```
+*/
+declare const verifyEmail: (email: string, options?: EmailVerificationOptions) => Promise<EmailVerificationResult>;
+export { EmailVerificationOptions, EmailVerificationResult, verifyEmail };

package/dist/utils/validation/verify-smtp.d.ts

@@ -1,39 +1,40 @@
-import type { Cache } from "../cache.d.ts";
-import type { MxCheckResult, MxRecord } from "./check-mx-records.d.ts";
+import { Cache } from "../cache.js";
+import { MxCheckResult, MxRecord } from "./check-mx-records.js";
 /**
- * Options for SMTP verification.
- */
-export interface SmtpVerificationOptions {
-    cache?: Cache<MxCheckResult>;
-    fromEmail?: string;
-    port?: number;
-    smtpCache?: Cache<SmtpVerificationResult>;
-    timeout?: number;
-    ttl?: number;
+* Options for SMTP verification.
+*/
+interface SmtpVerificationOptions {
+  cache?: Cache<MxCheckResult>;
+  fromEmail?: string;
+  port?: number;
+  smtpCache?: Cache<SmtpVerificationResult>;
+  timeout?: number;
+  ttl?: number;
 }
 /**
- * Detailed result of SMTP verification attempt.
- */
-export interface SmtpVerificationResult {
-    error?: string;
-    mxRecords?: MxRecord[];
-    smtpResponse?: string;
-    valid: boolean;
+* Detailed result of SMTP verification attempt.
+*/
+interface SmtpVerificationResult {
+  error?: string;
+  mxRecords?: MxRecord[];
+  smtpResponse?: string;
+  valid: boolean;
 }
 /**
- * Verifies an email address by checking MX records and attempting SMTP verification.
- * Note: Many mail servers block SMTP verification to prevent email harvesting.
- * @param email The email address to verify.
- * @param options Verification options.
- * @returns Result containing verification status.
- * @example
- * ```ts
- * import { verifySmtp } from "@visulima/email/validation/verify-smtp";
- *
- * const result = await verifySmtp("user@example.com", {
- *     timeout: 5000,
- *     fromEmail: "test@example.com"
- * });
- * ```
- */
-export declare const verifySmtp: (email: string, options?: SmtpVerificationOptions) => Promise<SmtpVerificationResult>;
+* Verifies an email address by checking MX records and attempting SMTP verification.
+* Note: Many mail servers block SMTP verification to prevent email harvesting.
+* @param email The email address to verify.
+* @param options Verification options.
+* @returns Result containing verification status.
+* @example
+* ```ts
+* import { verifySmtp } from "@visulima/email/validation/verify-smtp";
+*
+* const result = await verifySmtp("user@example.com", {
+*     timeout: 5000,
+*     fromEmail: "test@example.com"
+* });
+* ```
+*/
+declare const verifySmtp: (email: string, options?: SmtpVerificationOptions) => Promise<SmtpVerificationResult>;
+export { SmtpVerificationOptions, SmtpVerificationResult, verifySmtp };

package/package.json

@@ -1,52 +1,52 @@
 {
   "name": "@visulima/email",
-  "version": "1.0.0-alpha.16",
+  "version": "1.0.0-alpha.18",
   "description": "A comprehensive email library with multi-provider support, crypto utilities, and template engines",
   "keywords": [
-    "visulima",
-    "email",
-    "mail",
-    "better-mail",
-    "smtp",
-    "resend",
+    "ahasend",
     "aws-ses",
-    "zeptomail",
-    "http",
+    "azure",
+    "better-mail",
+    "brevo",
+    "crypto",
+    "disposable-email",
+    "disposable-email-domains",
+    "dkim",
+    "email",
+    "encryption",
     "failover",
-    "roundrobin",
+    "handlebars",
+    "html-to-text",
+    "http",
+    "infobip",
+    "mail",
     "mailcrab",
-    "nodemailer",
-    "opentelemetry",
-    "plunk",
-    "mock",
-    "sendgrid",
+    "mailersend",
     "mailgun",
-    "postmark",
-    "brevo",
     "mailjet",
-    "mailersend",
+    "mailomat",
+    "mailpace",
+    "mailtrap",
     "mandrill",
+    "mjml",
+    "mock",
+    "nodemailer",
+    "opentelemetry",
+    "plunk",
     "postal",
-    "mailtrap",
-    "mailpace",
-    "azure",
-    "infobip",
+    "postmark",
+    "react-email",
+    "resend",
+    "roundrobin",
     "scaleway",
-    "ahasend",
-    "mailomat",
-    "sweego",
-    "dkim",
-    "smime",
-    "encryption",
+    "sendgrid",
     "signing",
-    "crypto",
-    "disposable-email",
-    "disposable-email-domains",
-    "handlebars",
-    "mjml",
-    "react-email",
+    "smime",
+    "smtp",
+    "sweego",
+    "visulima",
     "vue-email",
-    "html-to-text"
+    "zeptomail"
   ],
   "homepage": "https://visulima.com/packages/email",
   "bugs": {
@@ -271,11 +271,11 @@
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.0.0 || ^2.0.0",
-    "@react-email/render": "^2.0.7",
+    "@react-email/render": "^2.0.8",
     "@vue-email/render": "0.0.9",
     "asn1js": "3.0.10",
     "handlebars": "4.7.9",
-    "mjml": "5.0.1",
+    "mjml": "5.1.0",
     "nodemailer": ">=7",
     "pkijs": "3.4.0"
   },

package/dist/attachment-helpers.d.ts

@@ -1,64 +0,0 @@
-import type { Buffer } from "node:buffer";
-/**
- * Detects MIME type from filename using mime package.
- * Falls back to application/octet-stream if not found.
- * @param filename The filename or path.
- * @returns MIME type or application/octet-stream as fallback.
- */
-export declare const detectMimeType: (filename: string) => string;
-/**
- * Generates a Content-ID for inline attachments.
- * @param filename The filename to generate CID from.
- * @returns A unique Content-ID string.
- */
-export declare const generateContentId: (filename: string) => string;
-/**
- * Reads file and returns its content as Buffer.
- * @param filePath Path to the file.
- * @returns Buffer containing file content.
- */
-export declare const readFileAsBuffer: (filePath: string) => Promise<Buffer>;
-/**
- * Attachment options for helper methods
- */
-export interface AttachmentOptions {
-    /**
-     * Content-ID for inline attachments (used in HTML with cid:).
-     * If not provided and contentDisposition is 'inline', will be auto-generated.
-     */
-    cid?: string;
-    /**
-     * Content disposition type.
-     * 'attachment' (default) or 'inline'.
-     */
-    contentDisposition?: "attachment" | "inline";
-    /**
-     * MIME type of the attachment.
-     * If not provided, will be detected from filename.
-     */
-    contentType?: string;
-    /**
-     * Content transfer encoding.
-     * Examples: 'base64', '7bit', 'quoted-printable'.
-     */
-    encoding?: string;
-    /**
-     * Custom filename.
-     * Used when different from the file path.
-     */
-    filename?: string;
-    /**
-     * Custom headers for this attachment.
-     */
-    headers?: Record<string, string>;
-}
-/**
- * Attachment data options (for raw data attachments)
- */
-export interface AttachmentDataOptions extends AttachmentOptions {
-    /**
-     * Filename for the attachment.
-     * Required for raw data attachments.
-     */
-    filename: string;
-}

package/dist/crypto/dkim-signer.d.ts

@@ -1,48 +0,0 @@
-import type { EmailOptions } from "../types.d.ts";
-import type { DkimOptions, EmailSigner } from "./types.d.ts";
-/**
- * DKIM signer implementation
- */
-export declare class DkimSigner implements EmailSigner {
-    /**
-     * Sanitizes a display name for use in quoted email headers per RFC 5322.
-     * Removes/replaces CR, LF, tabs with space, escapes backslashes and quotes,
-     * and strips non-printable control characters.
-     * @param name The display name to sanitize.
-     * @returns The sanitized display name, or empty string if nothing remains.
-     */
-    private static sanitizeDisplayName;
-    /**
-     * Formats an email address for use in email headers.
-     * @param address The email address object to format.
-     * @param address.email The email address string.
-     * @param address.name Optional display name for the email address.
-     * @returns The formatted email address string in RFC 5322 format.
-     */
-    private static formatAddress;
-    /**
-     * Formats email addresses for headers.
-     * @param addresses The email address(es) to format (single or array).
-     * @returns The formatted email addresses string (comma-separated if multiple).
-     */
-    private static formatAddresses;
-    private readonly options;
-    /**
-     * Creates a new DKIM signer.
-     * @param options DKIM signing options.
-     */
-    constructor(options: DkimOptions);
-    /**
-     * Signs an email message with DKIM.
-     * @param email The email options to sign.
-     * @returns The email options with DKIM signature header added.
-     * @throws {Error} When signing fails (e.g., invalid private key).
-     */
-    sign(email: EmailOptions): Promise<EmailOptions>;
-}
-/**
- * Creates a DKIM signer instance.
- * @param options DKIM signing options.
- * @returns A new DkimSigner instance.
- */
-export declare const createDkimSigner: (options: DkimOptions) => DkimSigner;