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

package/dist/packem_shared/provider.d-DcfYeGJJ.d.ts

@@ -0,0 +1,28 @@
+import { E as EmailOptions, F as FeatureFlags, R as Result, M as MaybePromise, a as EmailResult } from "./types.d-wwpgA3to.js";
+/**
+* Standard provider interface for email services.
+*/
+interface Provider<OptionsT = unknown, InstanceT = unknown, EmailOptionsT extends EmailOptions = EmailOptions> {
+  endpoint?: string;
+  features?: FeatureFlags;
+  getEmail?: (id: string) => MaybePromise<Result>;
+  getInstance?: () => InstanceT;
+  initialize: (options?: Record<string, unknown>) => MaybePromise<void>;
+  isAvailable: () => MaybePromise<boolean>;
+  name?: string;
+  options?: OptionsT;
+  sendEmail: (options: EmailOptionsT) => MaybePromise<Result<EmailResult>>;
+  shutdown?: () => MaybePromise<void>;
+  validateCredentials?: () => MaybePromise<boolean>;
+}
+/**
+* Type for provider factory function.
+*/
+type ProviderFactory<OptionsT = unknown, InstanceT = unknown, EmailOptionsT extends EmailOptions = EmailOptions> = (options?: OptionsT) => Provider<OptionsT, InstanceT, EmailOptionsT>;
+/**
+* Helper function to define an email provider.
+* @param factory The provider factory function.
+* @returns The same factory function (for type inference).
+*/
+declare const defineProvider: <OptionsT = unknown, InstanceT = unknown, EmailOptionsT extends EmailOptions = EmailOptions>(factory: ProviderFactory<OptionsT, InstanceT, EmailOptionsT>) => ProviderFactory<OptionsT, InstanceT, EmailOptionsT>;
+export { ProviderFactory as P, Provider as a, defineProvider as d };

package/dist/packem_shared/types.d-CNnnk-Ya.d.ts

@@ -0,0 +1,102 @@
+import { E as EmailOptions } from "./types.d-wwpgA3to.js";
+/**
+* Options for DKIM signing
+*/
+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
+*/
+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
+*/
+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
+*/
+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
+*/
+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>;
+}
+export { DkimOptions as D, EmailSigner as E, SmimeEncryptOptions as S, EmailEncrypter as a, SmimeSignOptions as b };

package/dist/packem_shared/types.d-nyR1ty1Q.d.ts

@@ -0,0 +1,9 @@
+/**
+* Template render function type.
+* @param template Template content (string, React component, etc.).
+* @param data Data/variables to pass to the template.
+* @param options Options specific to the template engine.
+* @returns Rendered HTML string.
+*/
+type TemplateRenderer = (template: unknown, data?: Record<string, unknown>, options?: Record<string, unknown>) => string | Promise<string>;
+export { TemplateRenderer as T };

package/dist/packem_shared/types.d-wwpgA3to.d.ts

@@ -0,0 +1,204 @@
+import { Buffer } from 'node:buffer';
+/**
+* Utility type for values that can be promises
+*/
+type MaybePromise<T> = T | Promise<T>;
+/**
+* Feature flags indicating what capabilities a provider supports
+*/
+interface FeatureFlags {
+  attachments?: boolean;
+  batchSending?: boolean;
+  customHeaders?: boolean;
+  html?: boolean;
+  replyTo?: boolean;
+  scheduling?: boolean;
+  tagging?: boolean;
+  templates?: boolean;
+  tracking?: boolean;
+}
+/**
+* Base configuration for all providers
+*/
+interface BaseConfig {
+  debug?: boolean;
+  logger?: Console;
+  retries?: number;
+  timeout?: number;
+}
+/**
+* Email address with optional name
+*/
+interface EmailAddress {
+  email: string;
+  name?: string;
+}
+/**
+* Email attachment
+*/
+interface Attachment {
+  /**
+  * Content-ID for inline attachments (used in HTML with cid:)
+  */
+  cid?: string;
+  /**
+  * Attachment content (string, Buffer, or Promise&lt;Uint8Array> for async loading)
+  * Required if path, href, or raw are not provided
+  */
+  content?: string | Buffer | Promise<Uint8Array>;
+  /**
+  * Content disposition: 'attachment' (default) or 'inline'
+  */
+  contentDisposition?: "attachment" | "inline";
+  /**
+  * MIME type of the attachment
+  */
+  contentType?: string;
+  /**
+  * Content transfer encoding (e.g., 'base64', '7bit', 'quoted-printable')
+  */
+  encoding?: string;
+  /**
+  * Filename for the attachment
+  */
+  filename: string;
+  /**
+  * Custom headers for this attachment
+  */
+  headers?: Record<string, string>;
+  /**
+  * URL to fetch attachment from
+  * Alternative to content or path
+  */
+  href?: string;
+  /**
+  * HTTP headers to use when fetching from href
+  */
+  httpHeaders?: Record<string, string>;
+  /**
+  * File path to read attachment from
+  * Alternative to content
+  */
+  path?: string;
+  /**
+  * Raw attachment data (alternative to content)
+  * Can be used for pre-encoded content
+  */
+  raw?: string | Buffer;
+}
+/**
+* Email tag for categorization
+*/
+interface EmailTag {
+  name: string;
+  value: string;
+}
+/**
+* Priority levels for email messages
+*/
+type Priority = "high" | "normal" | "low";
+/**
+* Represents the headers of an email message.
+* This type is a supertype of the standard `Headers` class, which is used to manage HTTP headers.
+* Note that this type does not include methods for modifying the headers,
+* such as `append`, `delete`, or `set`. It is intended to be used for
+* read-only access to the headers of an email message.
+*/
+type ImmutableHeaders = Omit<Headers, "append" | "delete" | "set">;
+/**
+* Email headers can be either a plain object or an ImmutableHeaders instance
+*/
+type EmailHeaders = Record<string, string> | ImmutableHeaders;
+/**
+* Options for calendar event attachments
+*/
+interface CalendarEventOptions {
+  /**
+  * Alternative text for the calendar event
+  */
+  alternativeText?: string;
+  /**
+  * Method for the calendar event (e.g., 'REQUEST', 'CANCEL', 'REPLY')
+  */
+  method?: string;
+}
+/**
+* Common email options that all providers support
+*/
+interface EmailOptions {
+  attachments?: Attachment[];
+  bcc?: EmailAddress | EmailAddress[];
+  cc?: EmailAddress | EmailAddress[];
+  from: EmailAddress;
+  headers?: EmailHeaders;
+  html?: string;
+  icalEvent?: CalendarEventOptions & {
+    content?: string;
+    href?: string;
+    path?: string;
+  };
+  priority?: Priority;
+  replyTo?: EmailAddress;
+  subject: string;
+  tags?: string[];
+  text?: string;
+  to: EmailAddress | EmailAddress[];
+}
+/**
+* Result of sending an email
+*/
+interface EmailResult {
+  messageId: string;
+  provider?: string;
+  response?: unknown;
+  sent: boolean;
+  timestamp: Date;
+}
+/**
+* Receipt type for email sending results
+* Uses discriminated union for type safety
+*/
+type Receipt = {
+  /**
+  * The unique identifier for the message that was sent
+  */
+  readonly messageId: string;
+  /**
+  * Optional provider name
+  */
+  readonly provider?: string;
+  /**
+  * Optional response data from provider
+  */
+  readonly response?: unknown;
+  /**
+  * Indicates that the email was sent successfully
+  */
+  readonly successful: true;
+  /**
+  * Timestamp when email was sent
+  */
+  readonly timestamp: Date;
+} | {
+  /**
+  * An array of error messages that occurred during the sending process
+  */
+  readonly errorMessages: ReadonlyArray<string>;
+  /**
+  * Optional provider name
+  */
+  readonly provider?: string;
+  /**
+  * Indicates that the email failed to send
+  */
+  readonly successful: false;
+};
+/**
+* Generic result type
+*/
+interface Result<T = unknown> {
+  data?: T;
+  error?: Error | unknown;
+  success: boolean;
+}
+export { Attachment as A, BaseConfig as B, CalendarEventOptions as C, EmailOptions as E, FeatureFlags as F, ImmutableHeaders as I, MaybePromise as M, Priority as P, Result as R, EmailResult as a, EmailAddress as b, EmailTag as c, Receipt as d, EmailHeaders as e };

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

@@ -1,3 +1,36 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as ahaSendProvider } from "./providers/ahasend/provider.d.ts";
-export type { AhaSendConfig, AhaSendEmailOptions } 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';
+/**
+* AhaSend configuration
+*/
+interface AhaSendConfig extends BaseConfig {
+  /**
+  * AhaSend API key
+  */
+  apiKey: string;
+  /**
+  * AhaSend API endpoint
+  * Defaults to: https://api.ahasend.com
+  */
+  endpoint?: string;
+}
+/**
+* AhaSend-specific email options
+*/
+interface AhaSendEmailOptions extends EmailOptions {
+  /**
+  * AhaSend template ID for template-based emails
+  */
+  templateId?: string;
+  /**
+  * Template variables for AhaSend templates
+  */
+  templateVariables?: Record<string, unknown>;
+}
+/**
+* AhaSend Provider for sending emails through AhaSend API
+*/
+declare const ahaSendProvider: ProviderFactory<AhaSendConfig>;
+export { type AhaSendConfig, type AhaSendEmailOptions, type ProviderFactory, ahaSendProvider };

package/dist/providers/aws-ses/index.d.ts

@@ -1,3 +1,47 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as awsSesProvider } from "./providers/aws-ses/provider.d.ts";
-export type { AwsSesConfig, AwsSesEmailOptions } 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';
+/**
+* AWS SES configuration
+*/
+interface AwsSesConfig extends BaseConfig {
+  accessKeyId: string;
+  apiVersion?: string;
+  endpoint?: string;
+  maxAttempts?: number;
+  region: string;
+  secretAccessKey: string;
+  sessionToken?: string;
+}
+/**
+* AWS SES-specific email options
+*/
+interface AwsSesEmailOptions extends EmailOptions {
+  /**
+  * Configuration set name
+  */
+  configurationSetName?: string;
+  /**
+  * Message tags as key-value pairs
+  */
+  messageTags?: Record<string, string>;
+  /**
+  * Return path email address
+  */
+  returnPath?: string;
+  /**
+  * Return path ARN
+  */
+  returnPathArn?: string;
+  /**
+  * Source ARN for sending authorization
+  */
+  sourceArn?: string;
+}
+/**
+* AWS SES Email Provider Implementation - Zero dependency version
+* Uses native Node.js APIs instead of AWS SDK
+*/
+declare const awsSesProvider: ProviderFactory<AwsSesConfig>;
+export { type AwsSesConfig, type AwsSesEmailOptions, type ProviderFactory, awsSesProvider };

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

@@ -1,3 +1,52 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as azureProvider } from "./providers/azure/provider.d.ts";
-export type { AzureConfig, AzureEmailOptions } 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';
+/**
+* Azure Communication Services configuration
+*/
+interface AzureConfig extends BaseConfig {
+  /**
+  * Azure AD access token (for OAuth2 authentication)
+  */
+  accessToken?: string;
+  /**
+  * Azure Communication Services connection string or access token
+  */
+  connectionString?: string;
+  /**
+  * Azure Communication Services endpoint
+  * Defaults to: https://{region}.communication.azure.com
+  */
+  endpoint?: string;
+  /**
+  * Azure region (e.g., "eastus", "westus")
+  */
+  region: string;
+}
+/**
+* Azure-specific email options
+*/
+interface AzureEmailOptions extends EmailOptions {
+  /**
+  * Custom headers
+  */
+  headers?: Record<string, string>;
+  /**
+  * Importance level (normal, high)
+  */
+  importance?: "normal" | "high";
+  /**
+  * Azure template ID for template-based emails
+  */
+  templateId?: string;
+  /**
+  * Template variables for Azure templates
+  */
+  templateVariables?: Record<string, unknown>;
+}
+/**
+* Azure Communication Services Provider for sending emails through Azure API
+*/
+declare const azureProvider: ProviderFactory<AzureConfig, unknown, AzureEmailOptions>;
+export { type AzureConfig, type AzureEmailOptions, type ProviderFactory, azureProvider };

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

@@ -1,3 +1,65 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as brevoProvider } from "./providers/brevo/provider.d.ts";
-export type { BrevoConfig, BrevoEmailOptions } 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, b as EmailAddress } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* Brevo configuration
+*/
+interface BrevoConfig extends BaseConfig {
+  /**
+  * Brevo API key
+  */
+  apiKey: string;
+  /**
+  * Brevo API endpoint
+  * Defaults to: https://api.brevo.com/v3
+  */
+  endpoint?: string;
+  /**
+  * Enable hard validation for replyTo addresses.
+  * If true, arrays will be rejected. If false, the first address from an array will be used.
+  * Defaults to: false
+  */
+  hardValidation?: boolean;
+}
+/**
+* Brevo-specific email options
+*/
+interface BrevoEmailOptions extends Omit<EmailOptions, "replyTo"> {
+  /**
+  * Batch ID for batch sending
+  */
+  batchId?: string;
+  /**
+  * Headers (custom headers)
+  */
+  headers?: Record<string, string>;
+  /**
+  * Reply-to email address (can override base replyTo).
+  * Only one address is allowed. If an array is provided and hardValidation is false, the first address will be used.
+  */
+  replyTo?: EmailAddress | EmailAddress[];
+  /**
+  * Scheduled date/time
+  * - If string: ISO 8601 format (e.g., "2025-01-15T10:00:00Z")
+  * - If number: Unix timestamp in seconds (not milliseconds)
+  */
+  scheduledAt?: string | number;
+  /**
+  * Tags for categorization
+  */
+  tags?: string[];
+  /**
+  * Brevo template ID for template-based emails
+  */
+  templateId?: number;
+  /**
+  * Template parameters for Brevo templates
+  */
+  templateParams?: Record<string, unknown>;
+}
+/**
+* Brevo Provider for sending emails through Brevo API
+*/
+declare const brevoProvider: ProviderFactory<BrevoConfig, unknown, BrevoEmailOptions>;
+export { type BrevoConfig, type BrevoEmailOptions, type ProviderFactory, brevoProvider };

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

@@ -1,3 +1,27 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as failoverProvider } from "./providers/failover/provider.d.ts";
-export type { FailoverConfig, FailoverEmailOptions } 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';
+/**
+* Failover configuration
+*/
+interface FailoverConfig extends BaseConfig {
+  /**
+  * Array of provider instances or provider factories to use in failover order
+  * Can be Provider instances or ProviderFactory functions
+  */
+  mailers: unknown[];
+  /**
+  * Time in milliseconds to wait before trying the next provider (default: 60)
+  */
+  retryAfter?: number;
+}
+/**
+* Failover-specific email options
+*/
+type FailoverEmailOptions = EmailOptions;
+/**
+* Failover Provider for sending emails with automatic failover to backup providers.
+*/
+declare const provider: ProviderFactory<FailoverConfig>;
+export { type FailoverConfig, type FailoverEmailOptions, type ProviderFactory, provider as failoverProvider };

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

@@ -1,3 +1,35 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as httpProvider } from "./providers/http/provider.d.ts";
-export type { HttpEmailConfig, HttpEmailOptions } 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 { E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
+/**
+* HTTP email configuration
+*/
+interface HttpEmailConfig {
+  apiKey?: string;
+  endpoint: string;
+  headers?: Record<string, string>;
+  method?: "GET" | "POST" | "PUT";
+}
+/**
+* HTTP-specific email options
+*/
+interface HttpEmailOptions extends EmailOptions {
+  /**
+  * Custom parameters to include in the request payload
+  */
+  customParams?: Record<string, unknown>;
+  /**
+  * Override the endpoint for this specific email
+  */
+  endpointOverride?: string;
+  /**
+  * Override the HTTP method for this specific email
+  */
+  methodOverride?: "GET" | "POST" | "PUT";
+}
+/**
+* HTTP Email Provider for sending emails via HTTP API.
+*/
+declare const httpProvider: ProviderFactory<HttpEmailConfig>;
+export { type HttpEmailConfig, type HttpEmailOptions, type ProviderFactory, httpProvider };

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

@@ -1,3 +1,56 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as infobipProvider } from "./providers/infobip/provider.d.ts";
-export type { InfobipConfig, InfobipEmailOptions } 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';
+/**
+* Infobip configuration
+*/
+interface InfobipConfig extends BaseConfig {
+  /**
+  * Infobip API key
+  */
+  apiKey: string;
+  /**
+  * Infobip base URL (e.g., "https://api.infobip.com")
+  */
+  baseUrl?: string;
+  /**
+  * Infobip API endpoint
+  * Defaults to: https://{baseUrl}/email/3/send
+  */
+  endpoint?: string;
+}
+/**
+* Infobip-specific email options
+*/
+interface InfobipEmailOptions extends EmailOptions {
+  /**
+  * Intermediate report (for delivery status updates)
+  */
+  intermediateReport?: boolean;
+  /**
+  * Notify URL (for delivery notifications)
+  */
+  notifyUrl?: string;
+  /**
+  * Send at (Unix timestamp in milliseconds)
+  */
+  sendAt?: number;
+  /**
+  * Infobip template ID for template-based emails
+  */
+  templateId?: number;
+  /**
+  * Template variables for Infobip templates
+  */
+  templateVariables?: Record<string, unknown>;
+  /**
+  * Tracking URL (for click tracking)
+  */
+  trackingUrl?: string;
+}
+/**
+* Infobip Provider for sending emails through Infobip API
+*/
+declare const infobipProvider: ProviderFactory<InfobipConfig>;
+export { type InfobipConfig, type InfobipEmailOptions, type ProviderFactory, infobipProvider };