@visulima/email 1.0.0-alpha.4 → 1.0.0-alpha.40

package/package.json

@@ -1,57 +1,70 @@
 {
   "name": "@visulima/email",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.40",
   "description": "A comprehensive email library with multi-provider support, crypto utilities, and template engines",
   "keywords": [
-    "visulima",
-    "email",
-    "mail",
-    "better-mail",
-    "smtp",
-    "resend",
+    "ahasend",
+    "arc",
     "aws-ses",
-    "zeptomail",
-    "http",
+    "azure",
+    "batch",
+    "better-mail",
+    "brevo",
+    "crypto",
+    "deliverability",
+    "disposable-email",
+    "disposable-email-domains",
+    "dkim",
+    "dmarc",
+    "email",
+    "encryption",
+    "i18n",
+    "inbound-email",
+    "jsx-email",
+    "liquid",
+    "list-unsubscribe",
+    "middleware",
+    "queue",
+    "webhook",
     "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",
+    "netcore",
+    "nodemailer",
+    "opentelemetry",
+    "outlook365",
+    "plunk",
     "postal",
-    "mailtrap",
-    "mailpace",
-    "azure",
-    "infobip",
+    "postmark",
+    "sparkpost",
+    "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": {
-    "url": "https://github.com/visulima/visulima/issues"
-  },
+  "bugs": "https://github.com/visulima/visulima/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -99,6 +112,18 @@
       "types": "./dist/template-engines/html-to-text.d.ts",
       "default": "./dist/template-engines/html-to-text.js"
     },
+    "./template/liquid": {
+      "types": "./dist/template-engines/liquid.d.ts",
+      "default": "./dist/template-engines/liquid.js"
+    },
+    "./template/jsx-email": {
+      "types": "./dist/template-engines/jsx-email.d.ts",
+      "default": "./dist/template-engines/jsx-email.js"
+    },
+    "./template/i18n": {
+      "types": "./dist/template-engines/i18n.d.ts",
+      "default": "./dist/template-engines/i18n.js"
+    },
     "./providers/aws-ses": {
       "types": "./dist/providers/aws-ses/index.d.ts",
       "default": "./dist/providers/aws-ses/index.js"
@@ -151,6 +176,58 @@
       "types": "./dist/crypto/index.d.ts",
       "default": "./dist/crypto/index.js"
     },
+    "./render": {
+      "types": "./dist/render/index.d.ts",
+      "default": "./dist/render/index.js"
+    },
+    "./webhooks": {
+      "types": "./dist/webhooks/index.d.ts",
+      "default": "./dist/webhooks/index.js"
+    },
+    "./deliverability": {
+      "types": "./dist/deliverability/index.d.ts",
+      "default": "./dist/deliverability/index.js"
+    },
+    "./deliverability/dmarc-report": {
+      "types": "./dist/deliverability/dmarc-report.d.ts",
+      "default": "./dist/deliverability/dmarc-report.js"
+    },
+    "./inbound": {
+      "types": "./dist/inbound/index.d.ts",
+      "default": "./dist/inbound/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "default": "./dist/events/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "default": "./dist/middleware/index.js"
+    },
+    "./queue": {
+      "types": "./dist/queue/index.d.ts",
+      "default": "./dist/queue/index.js"
+    },
+    "./queue/unstorage": {
+      "types": "./dist/queue/unstorage-queue.d.ts",
+      "default": "./dist/queue/unstorage-queue.js"
+    },
+    "./queue/sqs": {
+      "types": "./dist/queue/sqs-queue.d.ts",
+      "default": "./dist/queue/sqs-queue.js"
+    },
+    "./queue/pg-boss": {
+      "types": "./dist/queue/pg-boss-queue.d.ts",
+      "default": "./dist/queue/pg-boss-queue.js"
+    },
+    "./queue/bullmq": {
+      "types": "./dist/queue/bullmq-queue.d.ts",
+      "default": "./dist/queue/bullmq-queue.js"
+    },
+    "./test": {
+      "types": "./dist/test/index.d.ts",
+      "default": "./dist/test/index.js"
+    },
     "./providers/sendgrid": {
       "types": "./dist/providers/sendgrid/index.d.ts",
       "default": "./dist/providers/sendgrid/index.js"
@@ -215,10 +292,42 @@
       "types": "./dist/providers/sweego/index.d.ts",
       "default": "./dist/providers/sweego/index.js"
     },
+    "./providers/mailchannels": {
+      "types": "./dist/providers/mailchannels/index.d.ts",
+      "default": "./dist/providers/mailchannels/index.js"
+    },
+    "./providers/cloudflare-email": {
+      "types": "./dist/providers/cloudflare-email/index.d.ts",
+      "default": "./dist/providers/cloudflare-email/index.js"
+    },
+    "./providers/loops": {
+      "types": "./dist/providers/loops/index.d.ts",
+      "default": "./dist/providers/loops/index.js"
+    },
+    "./providers/sparkpost": {
+      "types": "./dist/providers/sparkpost/index.d.ts",
+      "default": "./dist/providers/sparkpost/index.js"
+    },
+    "./providers/netcore": {
+      "types": "./dist/providers/netcore/index.d.ts",
+      "default": "./dist/providers/netcore/index.js"
+    },
+    "./providers/outlook365": {
+      "types": "./dist/providers/outlook365/index.d.ts",
+      "default": "./dist/providers/outlook365/index.js"
+    },
     "./utils/parse-address": {
       "types": "./dist/utils/parse-address.d.ts",
       "default": "./dist/utils/parse-address.js"
     },
+    "./utils/parse-eml": {
+      "types": "./dist/utils/parse-eml.d.ts",
+      "default": "./dist/utils/parse-eml.js"
+    },
+    "./utils/result": {
+      "types": "./dist/utils/result.d.ts",
+      "default": "./dist/utils/result.js"
+    },
     "./utils/format-email-address": {
       "types": "./dist/utils/format-email-address.d.ts",
       "default": "./dist/utils/format-email-address.js"
@@ -251,6 +360,10 @@
       "types": "./dist/utils/validation/verify-email.d.ts",
       "default": "./dist/utils/validation/verify-email.js"
     },
+    "./validation/check-feature-support": {
+      "types": "./dist/utils/validation/check-feature-support.d.ts",
+      "default": "./dist/utils/validation/check-feature-support.js"
+    },
     "./utils/normalize-email-aliases": {
       "types": "./dist/utils/normalize-email-aliases.d.ts",
       "default": "./dist/utils/normalize-email-aliases.js"
@@ -263,21 +376,26 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@visulima/disposable-email-domains": "1.0.0-alpha.3",
-    "html-to-text": "^9.0.5",
-    "ical-generator": "^10.0.0",
-    "lru-cache": "^11.2.4",
+    "@visulima/disposable-email-domains": "1.0.0-alpha.17",
+    "html-to-text": "^10.0.0",
+    "ical-generator": "11.0.0",
+    "lru-cache": "11.5.1",
     "mime": "^4.1.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.0.0 || ^2.0.0",
-    "@react-email/render": "^2.0.0",
+    "@react-email/render": "^2.0.9",
     "@vue-email/render": "0.0.9",
-    "asn1js": "^3.0.0",
-    "handlebars": "^4.7.8",
-    "mjml": "^4.15.3",
+    "asn1js": "3.0.10",
+    "fast-xml-parser": "^4.5.0",
+    "handlebars": "4.7.9",
+    "jsx-email": "^2.0.0",
+    "juice": "^11.0.0",
+    "liquidjs": "^10.0.0",
+    "mjml": "5.3.0",
     "nodemailer": ">=7",
-    "pkijs": "^3.0.0"
+    "pkijs": "3.4.0",
+    "unstorage": "^1.13.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
@@ -292,9 +410,21 @@
     "asn1js": {
       "optional": true
     },
+    "fast-xml-parser": {
+      "optional": true
+    },
     "handlebars": {
       "optional": true
     },
+    "jsx-email": {
+      "optional": true
+    },
+    "juice": {
+      "optional": true
+    },
+    "liquidjs": {
+      "optional": true
+    },
     "mjml": {
       "optional": true
     },
@@ -303,10 +433,13 @@
     },
     "pkijs": {
       "optional": true
+    },
+    "unstorage": {
+      "optional": true
     }
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "publishConfig": {
     "access": "public",

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;

package/dist/crypto/smime-encrypter.d.ts

@@ -1,53 +0,0 @@
-import type { EmailOptions } from "../types.d.ts";
-import type { EmailEncrypter, SmimeEncryptOptions } from "./types.d.ts";
-/**
- * S/MIME encrypter implementation using PKIjs
- * Note: Requires pkijs and asn1js for S/MIME operations
- * Uses Node.js crypto for all cryptographic operations
- */
-export declare class SmimeEncrypter implements EmailEncrypter {
-    /**
-     * Collects and normalizes all recipients (to, cc, bcc) from email options.
-     * Normalizes each to an array, extracts email addresses, and deduplicates.
-     * @param email The email options containing recipients.
-     * @returns An array of unique email addresses (strings).
-     */
-    private static collectRecipients;
-    /**
-     * Formats an email address for use in email headers.
-     * @param address The email address to format (string or EmailAddress object).
-     * @returns The formatted email address string in RFC 5322 format.
-     */
-    private static formatAddress;
-    /**
-     * Formats email addresses for use in email headers.
-     * @param addresses The email addresses to format (single or array, string or EmailAddress objects).
-     * @returns The formatted email addresses string (comma-separated if multiple).
-     */
-    private static formatAddresses;
-    private readonly options;
-    /**
-     * Creates a new S/MIME encrypter.
-     * @param options S/MIME encryption options.
-     */
-    constructor(options: SmimeEncryptOptions);
-    /**
-     * Encrypts an email message with S/MIME.
-     * @param email The email options to encrypt.
-     * @returns The encrypted email options.
-     * @throws {Error} When encryption fails (e.g., invalid certificate).
-     */
-    encrypt(email: EmailOptions): Promise<EmailOptions>;
-    /**
-     * Builds the email message string from email options.
-     * @param email The email options to build the message from.
-     * @returns The formatted email message as a string.
-     */
-    private buildMessage;
-}
-/**
- * Creates a new S/MIME encrypter instance.
- * @param options The S/MIME encryption options.
- * @returns A new SmimeEncrypter instance ready to encrypt emails.
- */
-export declare const createSmimeEncrypter: (options: SmimeEncryptOptions) => SmimeEncrypter;

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

@@ -1,48 +0,0 @@
-import type { EmailOptions } from "../types.d.ts";
-import type { EmailSigner, SmimeSignOptions } from "./types.d.ts";
-/**
- * S/MIME signer implementation using PKIjs
- * Note: Requires pkijs and asn1js for S/MIME operations
- * Uses Node.js crypto for all cryptographic operations
- */
-export declare class SmimeSigner implements EmailSigner {
-    /**
-     * 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;
-    private readonly options;
-    /**
-     * Creates a new S/MIME signer.
-     * @param options S/MIME signing options.
-     */
-    constructor(options: SmimeSignOptions);
-    /**
-     * Signs an email message with S/MIME.
-     * @param email The email options to sign.
-     * @returns The email options with S/MIME signature.
-     * @throws {Error} When signing fails (e.g., invalid certificate/key).
-     */
-    sign(email: EmailOptions): Promise<EmailOptions>;
-    /**
-     * Builds the email message string from email options.
-     * @param email The email options to build the message from.
-     * @returns The formatted email message as a string.
-     */
-    private buildMessage;
-    /**
-     * Formats email addresses for use in email headers.
-     * @param addresses The email addresses to format (single or array).
-     * @returns The formatted email addresses string (comma-separated if multiple).
-     */
-    private formatAddresses;
-}
-/**
- * Creates a new S/MIME signer instance.
- * @param options The S/MIME signing options.
- * @returns A new SmimeSigner instance ready to sign emails.
- */
-export declare const createSmimeSigner: (options: SmimeSignOptions) => SmimeSigner;

package/dist/crypto/types.d.ts

@@ -1,101 +0,0 @@
-import type { EmailOptions } from "../types.d.ts";
-/**
- * Options for DKIM signing
- */
-export interface DkimOptions {
-    /**
-     * Body canonicalization algorithm ('simple' or 'relaxed')
-     * Default: 'simple'
-     */
-    bodyCanon?: "relaxed" | "simple";
-    /**
-     * Domain name used for DKIM signing
-     */
-    domainName: string;
-    /**
-     * Header canonicalization algorithm ('simple' or 'relaxed')
-     * Default: 'simple'
-     */
-    headerCanon?: "relaxed" | "simple";
-    /**
-     * List of header names to ignore when signing
-     */
-    headersToIgnore?: string[];
-    /**
-     * Key selector used for DNS lookup
-     */
-    keySelector: string;
-    /**
-     * Passphrase for the private key (if encrypted)
-     */
-    passphrase?: string;
-    /**
-     * Private key for signing (PEM format)
-     * Can be a string with the key content or a path prefixed with 'file://'
-     */
-    privateKey: string;
-}
-/**
- * Options for S/MIME signing
- */
-export interface SmimeSignOptions {
-    /**
-     * Path to the certificate file (PEM format)
-     */
-    certificate: string;
-    /**
-     * Path to intermediate certificates (optional)
-     */
-    intermediateCerts?: string[];
-    /**
-     * Signing options flags
-     * Reserved for future use
-     */
-    options?: number;
-    /**
-     * Passphrase for the private key (if encrypted)
-     */
-    passphrase?: string;
-    /**
-     * Path to the private key file (PEM format)
-     */
-    privateKey: string;
-}
-/**
- * Options for S/MIME encryption
- */
-export interface SmimeEncryptOptions {
-    /**
-     * Encryption algorithm (cipher)
-     * Supported: 'aes-256-cbc', 'aes-192-cbc', 'aes-128-cbc'
-     * Default: 'aes-256-cbc'
-     */
-    algorithm?: string;
-    /**
-     * Certificate(s) for encryption
-     * Can be a single certificate path or a map of email -> certificate path
-     */
-    certificates: string | Record<string, string>;
-}
-/**
- * Interface for email signers
- */
-export interface EmailSigner {
-    /**
-     * Sign an email message
-     * @param email The email options to sign
-     * @returns The signed email options (may include additional headers or modified content)
-     */
-    sign: (email: EmailOptions) => Promise<EmailOptions>;
-}
-/**
- * Interface for email encrypters
- */
-export interface EmailEncrypter {
-    /**
-     * Encrypt an email message
-     * @param email The email options to encrypt
-     * @returns The encrypted email options (content will be encrypted)
-     */
-    encrypt: (email: EmailOptions) => Promise<EmailOptions>;
-}

package/dist/draft-mail-message.d.ts

@@ -1,13 +0,0 @@
-import MailMessage from "./mail-message.d.ts";
-/**
- * Draft mail message - extends MailMessage with X-Unsent header automatically set.
- * Draft messages cannot be sent directly - they must be converted to regular messages first.
- */
-export declare class DraftMailMessage extends MailMessage {
-    /**
-     * Creates a new draft mail message.
-     * The X-Unsent header is automatically set to '1' to mark this as a draft.
-     */
-    constructor();
-}
-export default DraftMailMessage;

package/dist/errors/email-error.d.ts

@@ -1,17 +0,0 @@
-import { VisulimaError } from "@visulima/error";
-/**
- * Base error class for email package operations.
- * @param component The component name where the error occurred.
- * @param message The error message describing what went wrong.
- * @param options Optional error options including cause, code, and hint.
- */
-declare class EmailError extends VisulimaError {
-    readonly component: string;
-    readonly code?: string;
-    constructor(component: string, message: string, options?: {
-        cause?: Error | unknown;
-        code?: string;
-        hint?: string | string[];
-    });
-}
-export default EmailError;

package/dist/errors/required-option-error.d.ts

@@ -1,10 +0,0 @@
-import EmailError from "./email-error.d.ts";
-/**
- * Error for missing required options
- * @param component The component name where the error occurred
- * @param name The name(s) of the missing required option(s)
- */
-declare class RequiredOptionError extends EmailError {
-    constructor(component: string, name: string | string[]);
-}
-export default RequiredOptionError;