@visulima/email 1.0.0-alpha.8 → 1.0.0

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

@@ -1,3 +1,87 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as mandrillProvider } from "./providers/mandrill/provider.d.ts";
-export type { MandrillConfig, MandrillEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Mandrill configuration
+*/
+interface MandrillConfig extends BaseConfig {
+  /**
+  * Mandrill API key
+  */
+  apiKey: string;
+  /**
+  * Mandrill API endpoint
+  * Defaults to: https://mandrillapp.com/api/1.0
+  */
+  endpoint?: string;
+}
+/**
+* Mandrill-specific email options
+*/
+interface MandrillEmailOptions extends EmailOptions {
+  /**
+  * Global merge variables
+  */
+  globalMergeVars?: {
+    content: unknown;
+    name: string;
+  }[];
+  /**
+  * Google Analytics campaign
+  */
+  googleAnalyticsCampaign?: string;
+  /**
+  * Google Analytics domains
+  */
+  googleAnalyticsDomains?: string[];
+  /**
+  * Per-recipient merge variables
+  */
+  mergeVars?: {
+    rcpt: string;
+    vars: {
+      content: unknown;
+      name: string;
+    }[];
+  }[];
+  /**
+  * Metadata (key-value pairs)
+  */
+  metadata?: Record<string, string>;
+  /**
+  * Send at timestamp (ISO 8601 format)
+  */
+  sendAt?: string;
+  /**
+  * Subaccount ID
+  */
+  subaccount?: string;
+  /**
+  * Tags for categorization
+  */
+  tags?: string[];
+  /**
+  * Template content (for template-based emails)
+  */
+  templateContent?: {
+    content: string;
+    name: string;
+  }[];
+  /**
+  * Mandrill template name
+  */
+  templateName?: string;
+  /**
+  * Template variables (merge vars)
+  */
+  templateVariables?: {
+    content: unknown;
+    name: string;
+  }[];
+}
+/**
+* Mandrill Provider for sending emails through Mandrill API
+*/
+declare const mandrillProvider: ProviderFactory<MandrillConfig>;
+export { type MandrillConfig, type MandrillEmailOptions, type ProviderFactory, mandrillProvider };

package/dist/providers/mandrill/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/mandrillProvider-370y7CLu.js";export{d as mandrillProvider};
+import{default as d}from"../../packem_shared/mandrillProvider-DWPFh_Sj.js";export{d as mandrillProvider};

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

@@ -1,3 +1,12 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as mockProvider } from "./providers/mock/provider.d.ts";
-export type { MockConfig, MockEmailEntry, MockEmailOptions, RandomDelayRange } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { M as MockConfig, a as MockEmailEntry } from "../../packem_shared/types.d-DCkecJse.js";
+export type { b as MockEmailOptions, R as RandomDelayRange } from "../../packem_shared/types.d-DCkecJse.js";
+import "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Mock Provider for testing emails without actually sending them
+* Stores emails in memory for later retrieval and inspection
+*/
+declare const mockProvider: ProviderFactory<MockConfig, MockEmailEntry[]>;
+export { type MockConfig, type MockEmailEntry, type ProviderFactory, mockProvider };

package/dist/providers/mock/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/mockProvider-DN5ZwutD.js";export{e as mockProvider};
+import{default as e}from"../../packem_shared/mockProvider-Behywbl1.js";export{e as mockProvider};

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

@@ -0,0 +1,35 @@
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Netcore (Pepipost) configuration.
+*/
+interface NetcoreConfig extends BaseConfig {
+  /**
+  * Netcore Email API key (sent as the `api_key` header).
+  */
+  apiKey: string;
+  /**
+  * API endpoint override.
+  */
+  endpoint?: string;
+}
+/**
+* Netcore-specific email options.
+*/
+interface NetcoreEmailOptions extends EmailOptions {
+  /**
+  * Variables substituted into the Netcore template.
+  */
+  templateData?: Record<string, unknown>;
+  /**
+  * Stored template id to send instead of inline content.
+  */
+  templateId?: string;
+}
+/**
+* Netcore (Pepipost) provider — sends email through the Netcore Email API (v5.1).
+*/
+declare const netcoreProvider: ProviderFactory<NetcoreConfig>;
+export { type NetcoreConfig, type NetcoreEmailOptions, type ProviderFactory, netcoreProvider };

package/dist/providers/netcore/index.js

@@ -0,0 +1 @@
+import{default as o}from"../../packem_shared/netcoreProvider-C5TEciaN.js";export{o as netcoreProvider};

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

@@ -1,3 +1,38 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as nodemailerProvider } from "./providers/nodemailer/provider.d.ts";
-export type { NodemailerConfig, NodemailerEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { c as EmailAddress, B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Nodemailer configuration
+* Accepts any nodemailer transport configuration
+* Common transports: SMTP, Sendmail, SES, etc.
+*/
+interface NodemailerConfig extends BaseConfig {
+  /**
+  * Default from address (optional, can be overridden per email)
+  */
+  defaultFrom?: EmailAddress;
+  /**
+  * Nodemailer transport configuration
+  * Can be a transport object or a transport name (e.g., 'smtp', 'sendmail')
+  * For SMTP: { host, port, secure, auth: { user, pass } }
+  * For Sendmail: { path: '/usr/sbin/sendmail' }
+  * For SES: { SES: { ... } }
+  * See: https://nodemailer.com/transports/
+  */
+  transport: Record<string, unknown> | string;
+}
+/**
+* Nodemailer-specific email options
+*/
+interface NodemailerEmailOptions extends EmailOptions {
+  /**
+  * Override transport for this specific email
+  */
+  transportOverride?: Record<string, unknown> | string;
+}
+/**
+* Nodemailer Provider for sending emails via nodemailer
+*/
+declare const nodemailerProvider: ProviderFactory<NodemailerConfig>;
+export { type NodemailerConfig, type NodemailerEmailOptions, type ProviderFactory, nodemailerProvider };

package/dist/providers/nodemailer/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/nodemailerProvider-_w8QXMU-.js";export{o as nodemailerProvider};
+import{default as o}from"../../packem_shared/nodemailerProvider-BFHobXxt.js";export{o as nodemailerProvider};

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

@@ -1,3 +1,37 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as opentelemetryProvider } from "./providers/opentelemetry/provider.d.ts";
-export type { OpenTelemetryConfig, OpenTelemetryEmailOptions } from "./types.d.ts";
+import { a as Provider, P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { T as Tracer } from "../../packem_shared/tracer.d-MU42G1jG.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* OpenTelemetry configuration
+*/
+interface OpenTelemetryConfig extends BaseConfig {
+  /**
+  * The provider to wrap with OpenTelemetry instrumentation
+  * Can be a Provider instance or ProviderFactory function
+  */
+  provider: Provider | ProviderFactory;
+  /**
+  * Whether to record email content in spans (default: false)
+  * When false, only metadata is recorded
+  */
+  recordContent?: boolean;
+  /**
+  * Service name for OpenTelemetry spans (default: "email")
+  */
+  serviceName?: string;
+  /**
+  * Optional OpenTelemetry tracer instance
+  * If not provided, uses the global tracer
+  */
+  tracer?: Tracer;
+}
+/**
+* OpenTelemetry-specific email options
+*/
+type OpenTelemetryEmailOptions = EmailOptions;
+/**
+* OpenTelemetry Provider for instrumenting email sending with OpenTelemetry traces and metrics
+*/
+declare const opentelemetryProvider: ProviderFactory<OpenTelemetryConfig, Provider>;
+export { type OpenTelemetryConfig, type OpenTelemetryEmailOptions, type Provider, type ProviderFactory, opentelemetryProvider };

package/dist/providers/opentelemetry/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/opentelemetryProvider-C_ZXOLSd.js";export{o as opentelemetryProvider};
+import{default as o}from"../../packem_shared/opentelemetryProvider-ByHC01ub.js";export{o as opentelemetryProvider};

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

@@ -0,0 +1,48 @@
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { M as MaybePromise, B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Outlook365 / Microsoft Graph configuration.
+*
+* Authentication is delegated: supply a static `accessToken` or an async
+* `getAccessToken` (e.g. backed by `@azure/msal-node`). The provider never bundles an
+* auth SDK, so it stays dependency-light and runtime-agnostic.
+*/
+interface Outlook365Config extends BaseConfig {
+  /**
+  * A static OAuth2 access token with the `Mail.Send` scope. Prefer
+  * {@link Outlook365Config.getAccessToken} for tokens that expire.
+  */
+  accessToken?: string;
+  /**
+  * API endpoint override (default `https://graph.microsoft.com/v1.0`).
+  */
+  endpoint?: string;
+  /**
+  * Returns a fresh OAuth2 access token with the `Mail.Send` scope.
+  */
+  getAccessToken?: () => MaybePromise<string>;
+  /**
+  * Whether to keep a copy in the Sent Items folder (default true).
+  */
+  saveToSentItems?: boolean;
+  /**
+  * The mailbox to send as: a user id/UPN. Defaults to `me` (the token's own mailbox).
+  */
+  userId?: string;
+}
+/**
+* Outlook365-specific email options.
+*/
+interface Outlook365EmailOptions extends EmailOptions {
+  /**
+  * Message importance.
+  */
+  importance?: "high" | "low" | "normal";
+}
+/**
+* Outlook365 provider — sends email through the Microsoft Graph `sendMail` endpoint.
+*/
+declare const outlook365Provider: ProviderFactory<Outlook365Config>;
+export { type Outlook365Config, type Outlook365EmailOptions, type ProviderFactory, outlook365Provider };

package/dist/providers/outlook365/index.js

@@ -0,0 +1 @@
+import{default as e}from"../../packem_shared/outlook365Provider-63ggDpqV.js";export{e as outlook365Provider};

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

@@ -1,3 +1,38 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as plunkProvider } from "./providers/plunk/provider.d.ts";
-export type { PlunkConfig, PlunkEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Plunk configuration
+*/
+interface PlunkConfig extends BaseConfig {
+  apiKey: string;
+  endpoint?: string;
+}
+/**
+* Plunk-specific email options
+*/
+interface PlunkEmailOptions extends EmailOptions {
+  /**
+  * Data to pass to the email template
+  */
+  data?: Record<string, unknown>;
+  /**
+  * Subscriber email (used for tracking and analytics)
+  * If not provided, uses the first 'to' address
+  */
+  subscriber?: string;
+  /**
+  * Subscriber ID (optional identifier for the subscriber)
+  */
+  subscriberId?: string;
+  /**
+  * Template ID for template-based emails
+  */
+  templateId?: string;
+}
+/**
+* Plunk Provider for sending emails through Plunk API.
+*/
+declare const plunkProvider: ProviderFactory<PlunkConfig>;
+export { type PlunkConfig, type PlunkEmailOptions, type ProviderFactory, plunkProvider };

package/dist/providers/plunk/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/plunkProvider-DfJumQ4U.js";export{o as plunkProvider};
+import{default as o}from"../../packem_shared/plunkProvider-yTlrJVEp.js";export{o as plunkProvider};

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

@@ -1,3 +1,48 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as postalProvider } from "./providers/postal/provider.d.ts";
-export type { PostalConfig, PostalEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Postal configuration
+*/
+interface PostalConfig extends BaseConfig {
+  /**
+  * Postal server API key
+  */
+  apiKey: string;
+  /**
+  * Postal API endpoint
+  * Defaults to: https://{host}/api/v1
+  */
+  endpoint?: string;
+  /**
+  * Postal server host
+  */
+  host: string;
+}
+/**
+* Postal-specific email options
+*/
+interface PostalEmailOptions extends EmailOptions {
+  /**
+  * Postal message ID (for tracking)
+  */
+  postalMessageId?: string;
+  /**
+  * Tags for categorization
+  */
+  tags?: string[];
+  /**
+  * Postal template ID for template-based emails
+  */
+  templateId?: number;
+  /**
+  * Template variables for Postal templates
+  */
+  templateVariables?: Record<string, unknown>;
+}
+/**
+* Postal Provider for sending emails through Postal API.
+*/
+declare const postalProvider: ProviderFactory<PostalConfig>;
+export { type PostalConfig, type PostalEmailOptions, type ProviderFactory, postalProvider };

package/dist/providers/postal/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/postalProvider-Bavx2FcH.js";export{a as postalProvider};
+import{default as a}from"../../packem_shared/postalProvider-CRX_bMYD.js";export{a as postalProvider};

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

@@ -1,3 +1,60 @@
-export type { Provider, ProviderFactory } from "../provider.d.ts";
-export { default as postmarkProvider } from "./providers/postmark/provider.d.ts";
-export type { PostmarkConfig, PostmarkEmailOptions } from "./types.d.ts";
+import { P as ProviderFactory } from "../../packem_shared/provider.d-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Postmark configuration
+*/
+interface PostmarkConfig extends BaseConfig {
+  /**
+  * Postmark API endpoint
+  * Defaults to: https://api.postmarkapp.com
+  */
+  endpoint?: string;
+  /**
+  * Postmark Server API Token
+  */
+  serverToken: string;
+}
+/**
+* Postmark-specific email options
+*/
+interface PostmarkEmailOptions extends EmailOptions {
+  /**
+  * Inline CSS for HTML emails
+  */
+  inlineCss?: boolean;
+  /**
+  * Message stream ID
+  */
+  messageStream?: string;
+  /**
+  * Metadata (key-value pairs)
+  */
+  metadata?: Record<string, string>;
+  /**
+  * Postmark template alias (alternative to templateId)
+  */
+  templateAlias?: string;
+  /**
+  * Postmark template ID for template-based emails
+  */
+  templateId?: number;
+  /**
+  * Template model/variables for Postmark templates
+  */
+  templateModel?: Record<string, unknown>;
+  /**
+  * Track links
+  */
+  trackLinks?: "HtmlAndText" | "HtmlOnly" | "TextOnly" | "None";
+  /**
+  * Track opens
+  */
+  trackOpens?: boolean;
+}
+/**
+* Postmark Provider for sending emails through Postmark API.
+*/
+declare const postmarkProvider: ProviderFactory<PostmarkConfig>;
+export { type PostmarkConfig, type PostmarkEmailOptions, type ProviderFactory, postmarkProvider };

package/dist/providers/postmark/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/postmarkProvider-DFC0uvjO.js";export{a as postmarkProvider};
+import{default as a}from"../../packem_shared/postmarkProvider-CDx85Yge.js";export{a as postmarkProvider};

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-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions, d as EmailTag } from "../../packem_shared/types.d-ejzh-xBP.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/resend/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/resendProvider-CfqU7UdE.js";export{d as resendProvider};
+import{default as d}from"../../packem_shared/resendProvider-CiclWxzr.js";export{d as 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-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.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/roundrobin/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/roundRobinProvider-1WQnuKR8.js";export{d as roundRobinProvider};
+import{default as d}from"../../packem_shared/roundRobinProvider-D1by5KGW.js";export{d as 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-J-y6iogK.js";
+export type { a as Provider } from "../../packem_shared/provider.d-J-y6iogK.js";
+import { B as BaseConfig, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.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/scaleway/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/scalewayProvider-be1HPimL.js";export{r as scalewayProvider};
+import{default as r}from"../../packem_shared/scalewayProvider-BcND48qO.js";export{r as scalewayProvider};