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

package/dist/providers/resend/index.d.ts

@@ -1,3 +1,51 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as resendProvider } from "./providers/resend/provider.d.ts";
-export type { ResendConfig, ResendEmailOptions, ResendEmailTag } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions, c as EmailTag } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Resend configuration
+*/
+interface ResendConfig extends BaseConfig {
+  apiKey: string;
+  endpoint?: string;
+}
+/**
+* Resend-specific email tag type with additional constraints
+*/
+interface ResendEmailTag extends EmailTag {
+  /**
+  * Tag name - must only contain ASCII letters, numbers, underscores, or dashes
+  * Max length: 256 characters
+  */
+  name: string;
+  /**
+  * Tag value - must only contain ASCII letters, numbers, underscores, or dashes
+  */
+  value: string;
+}
+/**
+* Resend-specific email options
+*/
+interface ResendEmailOptions extends Omit<EmailOptions, "tags"> {
+  /**
+  * Schedule email for delivery at a specific time
+  */
+  scheduledAt?: Date | string;
+  /**
+  * Tags for categorizing emails
+  */
+  tags?: ResendEmailTag[];
+  /**
+  * Template data for template-based emails
+  */
+  templateData?: Record<string, unknown>;
+  /**
+  * Template ID for template-based emails
+  */
+  templateId?: string;
+}
+/**
+* Resend Provider for sending emails through Resend API.
+*/
+declare const resendProvider: ProviderFactory<ResendConfig, unknown, ResendEmailOptions>;
+export { type ProviderFactory, type ResendConfig, type ResendEmailOptions, type ResendEmailTag, resendProvider };

package/dist/providers/roundrobin/index.d.ts

@@ -1,3 +1,27 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as roundRobinProvider } from "./providers/roundrobin/provider.d.ts";
-export type { RoundRobinConfig, RoundRobinEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Round Robin configuration
+*/
+interface RoundRobinConfig extends BaseConfig {
+  /**
+  * Array of provider instances or provider factories to use for round-robin distribution
+  * Can be Provider instances or ProviderFactory functions
+  */
+  mailers: unknown[];
+  /**
+  * Time in milliseconds to wait before retrying with next provider if current is unavailable (default: 60)
+  */
+  retryAfter?: number;
+}
+/**
+* Round Robin-specific email options
+*/
+type RoundRobinEmailOptions = EmailOptions;
+/**
+* Round Robin Provider for distributing email sending across multiple providers
+*/
+declare const roundRobinProvider: ProviderFactory<RoundRobinConfig>;
+export { type ProviderFactory, type RoundRobinConfig, type RoundRobinEmailOptions, roundRobinProvider };

package/dist/providers/scaleway/index.d.ts

@@ -1,3 +1,44 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as scalewayProvider } from "./providers/scaleway/provider.d.ts";
-export type { ScalewayConfig, ScalewayEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Scaleway configuration
+*/
+interface ScalewayConfig extends BaseConfig {
+  /**
+  * Scaleway API key
+  */
+  apiKey: string;
+  /**
+  * Scaleway API endpoint
+  * Defaults to: https://api.scaleway.com/transactional-email/v1alpha1
+  */
+  endpoint?: string;
+  /**
+  * Scaleway region (e.g., "fr-par", "nl-ams")
+  */
+  region: string;
+}
+/**
+* Scaleway-specific email options
+*/
+interface ScalewayEmailOptions extends EmailOptions {
+  /**
+  * Project ID (optional)
+  */
+  projectId?: string;
+  /**
+  * Scaleway template ID for template-based emails
+  */
+  templateId?: string;
+  /**
+  * Template variables for Scaleway templates
+  */
+  templateVariables?: Record<string, unknown>;
+}
+/**
+* Scaleway Provider for sending emails through Scaleway API
+*/
+declare const scalewayProvider: ProviderFactory<ScalewayConfig>;
+export { type ProviderFactory, type ScalewayConfig, type ScalewayEmailOptions, scalewayProvider };

package/dist/providers/sendgrid/index.d.ts

@@ -1,3 +1,84 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as sendGridProvider } from "./providers/sendgrid/provider.d.ts";
-export type { SendGridConfig, SendGridEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* SendGrid configuration
+*/
+interface SendGridConfig extends BaseConfig {
+  apiKey: string;
+  endpoint?: string;
+}
+/**
+* SendGrid-specific email options
+*/
+interface SendGridEmailOptions extends EmailOptions {
+  /**
+  * ASM (Advanced Suppression Management) group ID for unsubscribe
+  */
+  asmGroupId?: number;
+  /**
+  * Batch ID for batch sending
+  */
+  batchId?: string;
+  /**
+  * IP pool name
+  */
+  ipPoolName?: string;
+  /**
+  * Mail settings (click tracking, open tracking, etc.)
+  */
+  mailSettings?: {
+    bypassListManagement?: boolean;
+    footer?: {
+      enable?: boolean;
+      html?: string;
+      text?: string;
+    };
+    sandboxMode?: boolean;
+  };
+  /**
+  * Send at timestamp (Unix timestamp)
+  */
+  sendAt?: number;
+  /**
+  * Dynamic template data for SendGrid dynamic templates
+  */
+  templateData?: Record<string, unknown>;
+  /**
+  * SendGrid template ID for template-based emails
+  */
+  templateId?: string;
+  /**
+  * Tracking settings
+  */
+  trackingSettings?: {
+    clickTracking?: {
+      enable?: boolean;
+      enableText?: boolean;
+    };
+    ganalytics?: {
+      enable?: boolean;
+      utmCampaign?: string;
+      utmContent?: string;
+      utmMedium?: string;
+      utmSource?: string;
+      utmTerm?: string;
+    };
+    openTracking?: {
+      enable?: boolean;
+      substitutionTag?: string;
+    };
+    subscriptionTracking?: {
+      enable?: boolean;
+      html?: string;
+      substitutionTag?: string;
+      text?: string;
+    };
+  };
+}
+/**
+* SendGrid Provider for sending emails through SendGrid API
+*/
+declare const sendGridProvider: ProviderFactory<SendGridConfig>;
+export { type ProviderFactory, type SendGridConfig, type SendGridEmailOptions, sendGridProvider };

package/dist/providers/smtp/index.d.ts

@@ -1,3 +1,71 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as smtpProvider } from "./providers/smtp/provider.d.ts";
-export type { SmtpConfig, SmtpEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* SMTP configuration
+*/
+interface SmtpConfig extends BaseConfig {
+  authMethod?: "LOGIN" | "PLAIN" | "CRAM-MD5" | "OAUTH2";
+  dkim?: {
+    domainName: string;
+    keySelector: string;
+    privateKey: string;
+  };
+  host: string;
+  maxConnections?: number;
+  oauth2?: {
+    accessToken?: string;
+    clientId: string;
+    clientSecret: string;
+    expires?: number;
+    refreshToken: string;
+    user: string;
+  };
+  password?: string;
+  pool?: boolean;
+  port: number;
+  rejectUnauthorized?: boolean;
+  secure?: boolean;
+  user?: string;
+}
+/**
+* SMTP-specific email options
+*/
+interface SmtpEmailOptions extends EmailOptions {
+  /**
+  * Delivery Status Notification options
+  */
+  dsn?: {
+    /** Request notification on delay */
+    delay?: boolean;
+    /** Request notification on failure */
+    failure?: boolean;
+    /** Request successful delivery notification */
+    success?: boolean;
+  };
+  /** Special Google Mail headers */
+  googleMailHeaders?: {
+    /** Category for email organization */
+    category?: "primary" | "social" | "promotions" | "updates" | "forums";
+    /** Feedback ID for engagement tracking */
+    feedbackId?: string;
+    /** Mark as promotional content */
+    promotionalContent?: boolean;
+  };
+  /** Reference to a previous message ID (for threading) */
+  inReplyTo?: string;
+  /** List-Unsubscribe header for easy unsubscribe functionality */
+  listUnsubscribe?: string | string[];
+  /** Message priority: 'high', 'normal', or 'low' */
+  priority?: "high" | "normal" | "low";
+  /** References to related message IDs */
+  references?: string | string[];
+  /** Whether to sign the email with DKIM */
+  useDkim?: boolean;
+}
+/**
+* SMTP provider for sending emails via SMTP protocol
+*/
+declare const smtpProvider: ProviderFactory<SmtpConfig>;
+export { type ProviderFactory, type SmtpConfig, type SmtpEmailOptions, smtpProvider };

package/dist/providers/sweego/index.d.ts

@@ -1,3 +1,40 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as sweegoProvider } from "./providers/sweego/provider.d.ts";
-export type { SweegoConfig, SweegoEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Sweego configuration
+*/
+interface SweegoConfig extends BaseConfig {
+  /**
+  * Sweego API key
+  */
+  apiKey: string;
+  /**
+  * Sweego API endpoint
+  * Defaults to: https://api.sweego.com
+  */
+  endpoint?: string;
+}
+/**
+* Sweego-specific email options
+*/
+interface SweegoEmailOptions extends EmailOptions {
+  /**
+  * Tags for categorization
+  */
+  tags?: string[];
+  /**
+  * Sweego template ID for template-based emails
+  */
+  templateId?: string;
+  /**
+  * Template variables for Sweego templates
+  */
+  templateVariables?: Record<string, unknown>;
+}
+/**
+* Sweego Provider for sending emails through Sweego API
+*/
+declare const sweegoProvider: ProviderFactory<SweegoConfig>;
+export { type ProviderFactory, type SweegoConfig, type SweegoEmailOptions, sweegoProvider };

package/dist/providers/zeptomail/index.d.ts

@@ -1,3 +1,37 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as zeptomailProvider } from "./providers/zeptomail/provider.d.ts";
-export type { ZeptomailConfig, ZeptomailEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+export { type a as Provider } from "../../packem_shared/provider.d-DcfYeGJJ.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Zeptomail configuration
+*/
+interface ZeptomailConfig extends BaseConfig {
+  endpoint?: string;
+  token: string;
+}
+/**
+* Zeptomail-specific email options
+*/
+interface ZeptomailEmailOptions extends EmailOptions {
+  /**
+  * Client reference - identifier set by the user to track a particular transaction
+  */
+  clientReference?: string;
+  /**
+  * MIME headers - additional headers sent in the email for reference
+  */
+  mimeHeaders?: Record<string, string>;
+  /**
+  * Track email clicks - enables tracking for click events
+  */
+  trackClicks?: boolean;
+  /**
+  * Track email opens - enables tracking for open events
+  */
+  trackOpens?: boolean;
+}
+/**
+* Zeptomail Provider for sending emails through Zeptomail API
+*/
+declare const zeptomailProvider: ProviderFactory<ZeptomailConfig>;
+export { type ProviderFactory, type ZeptomailConfig, type ZeptomailEmailOptions, zeptomailProvider };

package/dist/template-engines/handlebars.d.ts

@@ -1,25 +1,26 @@
-import type { TemplateRenderer } from "./types.d.ts";
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
 /**
- * Renders Handlebars template.
- * @param template Handlebars template string.
- * @param data Data to pass to the template.
- * @param options Handlebars compile options.
- * @returns Rendered HTML string.
- * @throws {TypeError} When template is not a string.
- * @throws {EmailError} When Handlebars is not installed or rendering fails.
- */
-export declare const renderHandlebars: TemplateRenderer;
+* Renders Handlebars template.
+* @param template Handlebars template string.
+* @param data Data to pass to the template.
+* @param options Handlebars compile options.
+* @returns Rendered HTML string.
+* @throws {TypeError} When template is not a string.
+* @throws {EmailError} When Handlebars is not installed or rendering fails.
+*/
+declare const renderHandlebars: TemplateRenderer;
 /**
- * Registers a Handlebars helper function for use in templates.
- * @param name The name of the helper to register.
- * @param helper The helper function to register.
- * @throws {EmailError} When Handlebars is not installed.
- */
-export declare const registerHandlebarsHelper: (name: string, helper: unknown) => void;
+* Registers a Handlebars helper function for use in templates.
+* @param name The name of the helper to register.
+* @param helper The helper function to register.
+* @throws {EmailError} When Handlebars is not installed.
+*/
+declare const registerHandlebarsHelper: (name: string, helper: unknown) => void;
 /**
- * Registers a Handlebars partial template for reuse in other templates.
- * @param name The name of the partial to register.
- * @param partial The partial template string to register.
- * @throws {EmailError} When Handlebars is not installed.
- */
-export declare const registerHandlebarsPartial: (name: string, partial: string) => void;
+* Registers a Handlebars partial template for reuse in other templates.
+* @param name The name of the partial to register.
+* @param partial The partial template string to register.
+* @throws {EmailError} When Handlebars is not installed.
+*/
+declare const registerHandlebarsPartial: (name: string, partial: string) => void;
+export { registerHandlebarsHelper, registerHandlebarsPartial, renderHandlebars };

package/dist/template-engines/html-to-text.d.ts

@@ -1,27 +1,27 @@
 /**
- * Converts HTML content to plain text format.
- * @param html The HTML string to convert.
- * @param options Configuration options for the html-to-text conversion.
- * @param options.longWordSplit Options for handling long words that exceed the word wrap limit.
- * @param options.longWordSplit.forceWrapOnLimit Whether to force wrap on the limit.
- * @param options.longWordSplit.wrapCharacters Characters to use for wrapping.
- * @param options.preserveNewlines Whether to preserve newlines in the output.
- * @param options.selectors Custom selectors for formatting specific HTML elements.
- * @param options.wordwrap The word wrap limit (number of characters) or false to disable.
- * @returns The converted plain text string.
- * @throws {EmailError} When html-to-text is not installed or conversion fails.
- */
+* Converts HTML content to plain text format.
+* @param html The HTML string to convert.
+* @param options Configuration options for the html-to-text conversion.
+* @param options.longWordSplit Options for handling long words that exceed the word wrap limit.
+* @param options.longWordSplit.forceWrapOnLimit Whether to force wrap on the limit.
+* @param options.longWordSplit.wrapCharacters Characters to use for wrapping.
+* @param options.preserveNewlines Whether to preserve newlines in the output.
+* @param options.selectors Custom selectors for formatting specific HTML elements.
+* @param options.wordwrap The word wrap limit (number of characters) or false to disable.
+* @returns The converted plain text string.
+* @throws {EmailError} When html-to-text is not installed or conversion fails.
+*/
 declare const htmlToText: (html: string, options?: {
-    longWordSplit?: {
-        forceWrapOnLimit?: boolean;
-        wrapCharacters?: string[];
-    };
-    preserveNewlines?: boolean;
-    selectors?: {
-        format?: string;
-        options?: Record<string, unknown>;
-        selector: string;
-    }[];
-    wordwrap?: number | false;
+  longWordSplit?: {
+    forceWrapOnLimit?: boolean;
+    wrapCharacters?: string[];
+  };
+  preserveNewlines?: boolean;
+  selectors?: {
+    format?: string;
+    options?: Record<string, unknown>;
+    selector: string;
+  }[];
+  wordwrap?: number | false;
 }) => string;
-export default htmlToText;
+export { htmlToText as default };

package/dist/template-engines/mjml.d.ts

@@ -1,12 +1,12 @@
-import type { TemplateRenderer } from "./types.d.ts";
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
 /**
- * Renders MJML to HTML.
- * @param template MJML template string.
- * @param _data Data (not used for MJML).
- * @param options MJML options (beautify, fonts, keepComments, minify, validationLevel).
- * @returns Rendered HTML string.
- * @throws {TypeError} When template is not a string.
- * @throws {EmailError} When MJML is not installed, validation fails, or rendering fails.
- */
+* Renders MJML to HTML.
+* @param template MJML template string.
+* @param _data Data (not used for MJML).
+* @param options MJML options (beautify, fonts, keepComments, minify, validationLevel).
+* @returns Rendered HTML string.
+* @throws {TypeError} When template is not a string.
+* @throws {EmailError} When MJML is not installed, validation fails, or rendering fails.
+*/
 declare const mjml: TemplateRenderer;
-export default mjml;
+export { mjml as default };

package/dist/template-engines/react-email.d.ts

@@ -1,11 +1,11 @@
-import type { TemplateRenderer } from "./types.d.ts";
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
 /**
- * Renders a React Email component to HTML.
- * @param template The React component from \@react-email/components to render.
- * @param _data Data object (not used for React Email, but kept for API compatibility).
- * @param options Render options including plainText and pretty formatting.
- * @returns The rendered HTML string.
- * @throws {EmailError} When \@react-email/render is not installed or rendering fails.
- */
+* Renders a React Email component to HTML.
+* @param template The React component from \@react-email/components to render.
+* @param _data Data object (not used for React Email, but kept for API compatibility).
+* @param options Render options including plainText and pretty formatting.
+* @returns The rendered HTML string.
+* @throws {EmailError} When \@react-email/render is not installed or rendering fails.
+*/
 declare const reactEmail: TemplateRenderer;
-export default reactEmail;
+export { reactEmail as default };

package/dist/template-engines/vue-email.d.ts

@@ -1,11 +1,11 @@
-import type { TemplateRenderer } from "./types.d.ts";
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
 /**
- * Renders a Vue Email component to HTML.
- * @param template The Vue component from \@vue-email/components to render.
- * @param data Data and variables to pass to the template.
- * @param options Render options including pretty formatting, plainText output, and htmlToTextOptions.
- * @returns The rendered HTML or plain text string.
- * @throws {EmailError} When \@vue-email/render is not installed or rendering fails.
- */
+* Renders a Vue Email component to HTML.
+* @param template The Vue component from \@vue-email/components to render.
+* @param data Data and variables to pass to the template.
+* @param options Render options including pretty formatting, plainText output, and htmlToTextOptions.
+* @returns The rendered HTML or plain text string.
+* @throws {EmailError} When \@vue-email/render is not installed or rendering fails.
+*/
 declare const vueEmail: TemplateRenderer;
-export default vueEmail;
+export { vueEmail as default };

package/dist/utils/cache.d.ts

@@ -1,54 +1,55 @@
 /**
- * Generic cache interface for caching any type of data.
- * Implementations can use in-memory cache, LRU cache, Redis, etc.
- */
-export interface Cache<T = unknown> {
-    /**
-     * Clears all cached entries.
-     */
-    clear: () => Promise<void>;
-    /**
-     * Deletes a cached entry.
-     * @param key The cache key.
-     */
-    delete: (key: string) => Promise<void>;
-    /**
-     * Gets a cached value.
-     * @param key The cache key.
-     * @returns The cached value or undefined if not found or expired.
-     */
-    get: (key: string) => Promise<T | undefined>;
-    /**
-     * Sets a cached value.
-     * @param key The cache key.
-     * @param value The value to cache.
-     * @param ttl Time-to-live in milliseconds.
-     */
-    set: (key: string, value: T, ttl: number) => Promise<void>;
+* Generic cache interface for caching any type of data.
+* Implementations can use in-memory cache, LRU cache, Redis, etc.
+*/
+interface Cache<T = unknown> {
+  /**
+  * Clears all cached entries.
+  */
+  clear: () => Promise<void>;
+  /**
+  * Deletes a cached entry.
+  * @param key The cache key.
+  */
+  delete: (key: string) => Promise<void>;
+  /**
+  * Gets a cached value.
+  * @param key The cache key.
+  * @returns The cached value or undefined if not found or expired.
+  */
+  get: (key: string) => Promise<T | undefined>;
+  /**
+  * Sets a cached value.
+  * @param key The cache key.
+  * @param value The value to cache.
+  * @param ttl Time-to-live in milliseconds.
+  */
+  set: (key: string, value: T, ttl: number) => Promise<void>;
 }
 /**
- * Options for creating an in-memory cache.
- */
-export interface InMemoryCacheOptions {
-    /**
-     * Maximum number of entries in the cache.
-     * @default 500
-     */
-    max?: number;
-    /**
-     * Default TTL in milliseconds for entries.
-     * @default 3600000 (1 hour)
-     */
-    ttl?: number;
+* Options for creating an in-memory cache.
+*/
+interface InMemoryCacheOptions {
+  /**
+  * Maximum number of entries in the cache.
+  * @default 500
+  */
+  max?: number;
+  /**
+  * Default TTL in milliseconds for entries.
+  * @default 3600000 (1 hour)
+  */
+  ttl?: number;
 }
 /**
- * Default in-memory cache implementation using LRU cache.
- */
-export declare class InMemoryCache<T extends object = Record<string, unknown>> implements Cache<T> {
-    private readonly cache;
-    constructor(options?: InMemoryCacheOptions);
-    clear: () => Promise<void>;
-    delete: (key: string) => Promise<void>;
-    get: (key: string) => Promise<T | undefined>;
-    set: (key: string, value: T, ttl: number) => Promise<void>;
+* Default in-memory cache implementation using LRU cache.
+*/
+declare class InMemoryCache<T extends object = Record<string, unknown>> implements Cache<T> {
+  private readonly cache;
+  constructor(options?: InMemoryCacheOptions);
+  clear: () => Promise<void>;
+  delete: (key: string) => Promise<void>;
+  get: (key: string) => Promise<T | undefined>;
+  set: (key: string, value: T, ttl: number) => Promise<void>;
 }
+export { Cache, InMemoryCache, InMemoryCacheOptions };