@visulima/email 2.1.6 → 2.1.8

package/dist/middleware/index.d.ts

@@ -1,246 +1,243 @@
-import { M as Middleware } from "../packem_shared/types.d-Mpu0HZoG.js";
-export { type S as SendFunction, c as composeMiddleware } from "../packem_shared/types.d-Mpu0HZoG.js";
-import { E as EmailOptions, M as MaybePromise, a as EmailResult, R as Result, c as EmailAddress } from "../packem_shared/types.d-ejzh-xBP.js";
-import { d as EventBus } from "../packem_shared/event-bus.d-DEl3w_EW.js";
-import { b as SuppressionStore } from "../packem_shared/types.d-CmoWvdZi.js";
-import { T as Tracer } from "../packem_shared/tracer.d-MU42G1jG.js";
+import { M as Middleware } from "../packem_shared/types.d-GKqPNk0I.js";
+export { type S as SendFunction, c as composeMiddleware } from "../packem_shared/types.d-GKqPNk0I.js";
+import { E as EmailOptions, M as MaybePromise, a as EmailResult, R as Result, c as EmailAddress } from "../packem_shared/types.d-B9295M4_.js";
+import { d as EventBus } from "../packem_shared/event-bus.d-BNQA-FZE.js";
+import { b as SuppressionStore } from "../packem_shared/types.d-BzoHR9nB.js";
+import { T as Tracer } from "../packem_shared/tracer.d-sb5yrt_n.js";
 import 'node:buffer';
 /**
-* The state of a {@link circuitBreakerMiddleware}.
-*
-* `closed` = healthy; `open` = failing fast; `half-open` = trialing one request to test recovery.
-*/
+ * The state of a {@link circuitBreakerMiddleware}.
+ *
+ * `closed` = healthy; `open` = failing fast; `half-open` = trialing one request to test recovery.
+ */
 type CircuitState = "closed" | "half-open" | "open";
 /**
-* Options for the {@link circuitBreakerMiddleware}.
-*/
+ * Options for the {@link circuitBreakerMiddleware}.
+ */
 interface CircuitBreakerMiddlewareOptions {
   /**
-  * Consecutive failures before the circuit opens.
-  * @default 5
-  */
+   * Consecutive failures before the circuit opens.
+   * @default 5
+   */
   failureThreshold?: number;
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
   /**
-  * Notified whenever the circuit changes state.
-  * @param state The new state.
-  */
+   * Notified whenever the circuit changes state.
+   * @param state The new state.
+   */
   onStateChange?: (state: CircuitState) => void;
   /**
-  * How long, in milliseconds, the circuit stays open before allowing a half-open trial.
-  * @default 30000
-  */
+   * How long, in milliseconds, the circuit stays open before allowing a half-open trial.
+   * @default 30000
+   */
   resetTimeout?: number;
 }
 /**
-* Trips a circuit after repeated provider failures, failing fast while open and trialing recovery via
-* a half-open state — protecting a struggling provider from being hammered.
-* @param options Breaker configuration. See {@link CircuitBreakerMiddlewareOptions}.
-* @returns A middleware that fails fast while the provider is unhealthy.
-*/
+ * Trips a circuit after repeated provider failures, failing fast while open and trialing recovery via
+ * a half-open state — protecting a struggling provider from being hammered.
+ * @param options Breaker configuration. See {@link CircuitBreakerMiddlewareOptions}.
+ * @returns A middleware that fails fast while the provider is unhealthy.
+ */
 declare const circuitBreakerMiddleware: (options?: CircuitBreakerMiddlewareOptions) => Middleware;
 /**
-* Options for the {@link dedupeMiddleware}.
-*/
+ * Options for the {@link dedupeMiddleware}.
+ */
 interface DedupeMiddlewareOptions {
   /**
-  * Derives the dedupe key for a message. Defaults to a content hash of recipients + subject + body.
-  * @param options The message being sent.
-  */
+   * Derives the dedupe key for a message. Defaults to a content hash of recipients + subject + body.
+   * @param options The message being sent.
+   */
   keyFn?: (options: EmailOptions) => string;
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
   /**
-  * How long, in milliseconds, a key is remembered.
-  * @default 60000
-  */
+   * How long, in milliseconds, a key is remembered.
+   * @default 60000
+   */
   ttl?: number;
 }
 /**
-* Suppresses duplicate sends of the same message within a TTL window, returning the original result
-* for repeats instead of re-sending.
-*
-* Useful behind at-least-once delivery sources (queues, webhooks) that may replay a message.
-* @param options Dedupe configuration. See {@link DedupeMiddlewareOptions}.
-* @returns A middleware that drops duplicate sends within the TTL.
-*/
+ * Suppresses duplicate sends of the same message within a TTL window, returning the original result
+ * for repeats instead of re-sending.
+ *
+ * Useful behind at-least-once delivery sources (queues, webhooks) that may replay a message.
+ * @param options Dedupe configuration. See {@link DedupeMiddlewareOptions}.
+ * @returns A middleware that drops duplicate sends within the TTL.
+ */
 declare const dedupeMiddleware: (options?: DedupeMiddlewareOptions) => Middleware;
 /**
-* Options for {@link withEvents}.
-*/
+ * Options for {@link withEvents}.
+ */
 interface EventsMiddlewareOptions {
   /**
-  * Generates event ids. Defaults to `crypto.randomUUID`.
-  */
+   * Generates event ids. Defaults to `crypto.randomUUID`.
+   */
   idFactory?: () => string;
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
 }
 /**
-* Emits unified `EmailEvent`s onto an {@link EventBus} around each send: `queued` before, then
-* `sent` or `failed` after. Combine with webhook-derived events for a single timeline per message.
-* @param bus The event bus to publish to.
-* @param options Middleware options. See {@link EventsMiddlewareOptions}.
-* @returns A middleware that publishes send-lifecycle events.
-*/
+ * Emits unified `EmailEvent`s onto an {@link EventBus} around each send: `queued` before, then
+ * `sent` or `failed` after. Combine with webhook-derived events for a single timeline per message.
+ * @param bus The event bus to publish to.
+ * @param options Middleware options. See {@link EventsMiddlewareOptions}.
+ * @returns A middleware that publishes send-lifecycle events.
+ */
 declare const withEvents: (bus: EventBus, options?: EventsMiddlewareOptions) => Middleware;
 /**
-* Options for the {@link loggingMiddleware}.
-*/
+ * Options for the {@link loggingMiddleware}.
+ */
 interface LoggingMiddlewareOptions {
   /**
-  * The logger to write to.
-  * @default console
-  */
+   * The logger to write to.
+   * @default console
+   */
   logger?: Pick<Console, "error" | "info">;
   /**
-  * Redact recipient addresses (e.g. `j••@example.com`) to keep PII out of logs.
-  * @default true
-  */
+   * Redact recipient addresses (e.g. `j••@example.com`) to keep PII out of logs.
+   * @default true
+   */
   redact?: boolean;
 }
 /**
-* Logs each send attempt and its outcome, redacting recipient PII by default.
-* @param options Logging configuration. See {@link LoggingMiddlewareOptions}.
-* @returns A middleware that logs sends and their results.
-*/
+ * Logs each send attempt and its outcome, redacting recipient PII by default.
+ * @param options Logging configuration. See {@link LoggingMiddlewareOptions}.
+ * @returns A middleware that logs sends and their results.
+ */
 declare const loggingMiddleware: (options?: LoggingMiddlewareOptions) => Middleware;
 /**
-* A minimal metrics sink — implement it with prom-client, OpenTelemetry metrics, StatsD, etc.
-*/
+ * A minimal metrics sink — implement it with prom-client, OpenTelemetry metrics, StatsD, etc.
+ */
 interface MetricsRecorder {
   /**
-  * Increments a counter.
-  * @param metric The metric name.
-  * @param labels Optional labels/dimensions.
-  */
+   * Increments a counter.
+   * @param metric The metric name.
+   * @param labels Optional labels/dimensions.
+   */
   increment: (metric: string, labels?: Record<string, string>) => void;
   /**
-  * Records an observation (e.g. a duration) on a histogram/summary.
-  * @param metric The metric name.
-  * @param value The observed value.
-  * @param labels Optional labels/dimensions.
-  */
+   * Records an observation (e.g. a duration) on a histogram/summary.
+   * @param metric The metric name.
+   * @param value The observed value.
+   * @param labels Optional labels/dimensions.
+   */
   observe: (metric: string, value: number, labels?: Record<string, string>) => void;
 }
 /**
-* Options for {@link withMetrics}.
-*/
+ * Options for {@link withMetrics}.
+ */
 interface MetricsMiddlewareOptions {
   /**
-  * Prefix for emitted metric names.
-  * @default "email_"
-  */
+   * Prefix for emitted metric names.
+   * @default "email_"
+   */
   prefix?: string;
 }
 /**
-* Records per-send metrics (a `*_sent_total` counter and a `*_duration_ms` observation, labelled by
-* provider and status) into an injected {@link MetricsRecorder}. Dependency-free — wire it to
-* prom-client or any metrics backend.
-* @param recorder The metrics sink.
-* @param options Middleware options. See {@link MetricsMiddlewareOptions}.
-* @returns A middleware that records send metrics.
-*/
+ * Records per-send metrics (a `*_sent_total` counter and a `*_duration_ms` observation, labelled by
+ * provider and status) into an injected {@link MetricsRecorder}. Dependency-free — wire it to
+ * prom-client or any metrics backend.
+ * @param recorder The metrics sink.
+ * @param options Middleware options. See {@link MetricsMiddlewareOptions}.
+ * @returns A middleware that records send metrics.
+ */
 declare const withMetrics: (recorder: MetricsRecorder, options?: MetricsMiddlewareOptions) => Middleware;
 /**
-* A token that may carry an absolute expiry.
-*/
+ * A token that may carry an absolute expiry.
+ */
 interface CacheableToken {
   /**
-  * The bearer access token.
-  */
+   * The bearer access token.
+   */
   accessToken: string;
   /**
-  * Absolute expiry time in milliseconds since the epoch. Omit for non-expiring tokens.
-  */
+   * Absolute expiry time in milliseconds since the epoch. Omit for non-expiring tokens.
+   */
   expiresAt?: number;
 }
 /**
-* Options for {@link createTokenCache}.
-*/
-/**
-* An OAuth2 access token plus its expiry.
-*/
+ * An OAuth2 access token plus its expiry.
+ */
 type OAuth2Token = CacheableToken;
 /**
-* Options for the {@link oauth2Middleware}.
-*/
+ * Options for the {@link oauth2Middleware}.
+ */
 interface OAuth2MiddlewareOptions {
   /**
-  * Fetches (or refreshes) the access token. Called only when the cached token is missing or within
-  * {@link OAuth2MiddlewareOptions.skewMs} of expiry. Wire this to your Gmail / Microsoft 365 refresh
-  * flow.
-  */
+   * Fetches (or refreshes) the access token. Called only when the cached token is missing or within
+   * {@link OAuth2MiddlewareOptions.skewMs} of expiry. Wire this to your Gmail / Microsoft 365 refresh
+   * flow.
+   */
   fetchToken: () => Promise<OAuth2Token> | OAuth2Token;
   /**
-  * The header to inject the credential into.
-  * @default "Authorization"
-  */
+   * The header to inject the credential into.
+   * @default "Authorization"
+   */
   headerName?: string;
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
   /**
-  * Receives every freshly-acquired token — use it to feed SMTP XOAUTH2 or a provider client that
-  * authenticates outside the message headers.
-  * @param token The new token.
-  */
+   * Receives every freshly-acquired token — use it to feed SMTP XOAUTH2 or a provider client that
+   * authenticates outside the message headers.
+   * @param token The new token.
+   */
   onToken?: (token: OAuth2Token) => void;
   /**
-  * The auth scheme prefix for the header value.
-  * @default "Bearer"
-  */
+   * The auth scheme prefix for the header value.
+   * @default "Bearer"
+   */
   scheme?: string;
   /**
-  * Refresh this many milliseconds before the token actually expires.
-  * @default 60000
-  */
+   * Refresh this many milliseconds before the token actually expires.
+   * @default 60000
+   */
   skewMs?: number;
 }
 /**
-* Injects an OAuth2 bearer credential into each outgoing message, refreshing it on demand and caching
-* it until just before expiry.
-*
-* Supplies the token to provider clients (Gmail, Microsoft 365) either via a request header or the
-* {@link OAuth2MiddlewareOptions.onToken} callback (for SMTP XOAUTH2).
-* @param options OAuth2 configuration. See {@link OAuth2MiddlewareOptions}.
-* @returns The middleware.
-*/
+ * Injects an OAuth2 bearer credential into each outgoing message, refreshing it on demand and caching
+ * it until just before expiry.
+ *
+ * Supplies the token to provider clients (Gmail, Microsoft 365) either via a request header or the
+ * {@link OAuth2MiddlewareOptions.onToken} callback (for SMTP XOAUTH2).
+ * @param options OAuth2 configuration. See {@link OAuth2MiddlewareOptions}.
+ * @returns The middleware.
+ */
 declare const oauth2Middleware: (options: OAuth2MiddlewareOptions) => Middleware;
 /**
-* Options for the {@link rateLimitMiddleware}.
-*/
+ * Options for the {@link rateLimitMiddleware}.
+ */
 interface RateLimitMiddlewareOptions {
   /**
-  * Maximum burst capacity (tokens). Defaults to {@link RateLimitMiddlewareOptions.rate}.
-  */
+   * Maximum burst capacity (tokens). Defaults to {@link RateLimitMiddlewareOptions.rate}.
+   */
   burst?: number;
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
   /**
-  * Sustained send rate, in messages per second.
-  */
+   * Sustained send rate, in messages per second.
+   */
   rate: number;
   /**
-  * Sleep implementation — injectable for tests. Defaults to `setTimeout`.
-  * @param ms Milliseconds to wait.
-  */
+   * Sleep implementation — injectable for tests. Defaults to `setTimeout`.
+   * @param ms Milliseconds to wait.
+   */
   sleep?: (ms: number) => Promise<void>;
 }
 /**
-* Pre-tuned per-second rate presets for common providers' default plans. Override as needed for your
-* own quota.
-*/
+ * Pre-tuned per-second rate presets for common providers' default plans. Override as needed for your
+ * own quota.
+ */
 declare const RATE_LIMIT_PRESETS: {
   readonly "aws-ses": 14;
   readonly mailgun: 100;
@@ -249,106 +246,106 @@ declare const RATE_LIMIT_PRESETS: {
   readonly sendgrid: 100;
 };
 /**
-* Throttles sends with a token-bucket limiter, awaiting capacity rather than failing when the rate is
-* exceeded.
-* @param options Rate configuration. See {@link RateLimitMiddlewareOptions} and {@link RATE_LIMIT_PRESETS}.
-* @returns A middleware that paces sends to the configured rate.
-*/
+ * Throttles sends with a token-bucket limiter, awaiting capacity rather than failing when the rate is
+ * exceeded.
+ * @param options Rate configuration. See {@link RateLimitMiddlewareOptions} and {@link RATE_LIMIT_PRESETS}.
+ * @returns A middleware that paces sends to the configured rate.
+ */
 declare const rateLimitMiddleware: (options: RateLimitMiddlewareOptions) => Middleware;
 /**
-* Wraps a transform that rewrites the message before it is sent — e.g. running the HTML through the
-* render helpers (preheader, dark-mode, CID rewrite) and the opt-in CSS inliner.
-* @param transform Maps the resolved {@link EmailOptions} to its rendered form.
-* @returns A middleware that applies the transform ahead of the provider call.
-* @example
-* ```ts
-* import { injectPreheader } from "@visulima/email/render/preheader";
-* import { addDarkModeSupport } from "@visulima/email/render/dark-mode";
-*
-* mail.use(withRender(async (email) => ({
-*   ...email,
-*   html: email.html ? addDarkModeSupport(injectPreheader(email.html, "Hi!")) : email.html,
-* })));
-* ```
-*/
+ * Wraps a transform that rewrites the message before it is sent — e.g. running the HTML through the
+ * render helpers (preheader, dark-mode, CID rewrite) and the opt-in CSS inliner.
+ * @param transform Maps the resolved {@link EmailOptions} to its rendered form.
+ * @returns A middleware that applies the transform ahead of the provider call.
+ * @example
+ * ```ts
+ * import { injectPreheader } from "@visulima/email/render/preheader";
+ * import { addDarkModeSupport } from "@visulima/email/render/dark-mode";
+ *
+ * mail.use(withRender(async (email) => ({
+ *   ...email,
+ *   html: email.html ? addDarkModeSupport(injectPreheader(email.html, "Hi!")) : email.html,
+ * })));
+ * ```
+ */
 declare const withRender: (transform: (options: EmailOptions) => MaybePromise<EmailOptions>) => Middleware;
 /**
-* Options for the {@link retryMiddleware}.
-*/
+ * Options for the {@link retryMiddleware}.
+ */
 interface RetryMiddlewareOptions {
   /**
-  * The base backoff delay in milliseconds. Actual delays grow exponentially and are jittered.
-  * @default 200
-  */
+   * The base backoff delay in milliseconds. Actual delays grow exponentially and are jittered.
+   * @default 200
+   */
   baseDelay?: number;
   /**
-  * Called when all retries are exhausted — a dead-letter hook for durable storage/alerting.
-  * @param options The message that ultimately failed.
-  * @param result The final failed result.
-  */
+   * Called when all retries are exhausted — a dead-letter hook for durable storage/alerting.
+   * @param options The message that ultimately failed.
+   * @param result The final failed result.
+   */
   onDeadLetter?: (options: EmailOptions, result: Result<EmailResult>) => Promise<void> | void;
   /**
-  * Maximum number of attempts (including the first).
-  * @default 3
-  */
+   * Maximum number of attempts (including the first).
+   * @default 3
+   */
   retries?: number;
   /**
-  * Decides whether a failed result is retryable. Defaults to retrying every failure.
-  * @param result The failed result.
-  */
+   * Decides whether a failed result is retryable. Defaults to retrying every failure.
+   * @param result The failed result.
+   */
   shouldRetry?: (result: Result<EmailResult>) => boolean;
   /**
-  * Sleep implementation — injectable for tests. Defaults to `setTimeout`.
-  * @param ms Milliseconds to wait.
-  */
+   * Sleep implementation — injectable for tests. Defaults to `setTimeout`.
+   * @param ms Milliseconds to wait.
+   */
   sleep?: (ms: number) => Promise<void>;
 }
 /**
-* Retries failed sends with full-jitter exponential backoff, optionally dead-lettering the final
-* failure.
-*
-* Full jitter (`random(0, base * 2^attempt)`) avoids the thundering-herd retries a fixed schedule
-* causes.
-* @param options Retry configuration. See {@link RetryMiddlewareOptions}.
-* @returns A middleware that re-attempts failed sends before giving up.
-*/
+ * Retries failed sends with full-jitter exponential backoff, optionally dead-lettering the final
+ * failure.
+ *
+ * Full jitter (`random(0, base * 2^attempt)`) avoids the thundering-herd retries a fixed schedule
+ * causes.
+ * @param options Retry configuration. See {@link RetryMiddlewareOptions}.
+ * @returns A middleware that re-attempts failed sends before giving up.
+ */
 declare const retryMiddleware: (options?: RetryMiddlewareOptions) => Middleware;
 /**
-* Options for {@link withSuppression}.
-*/
+ * Options for {@link withSuppression}.
+ */
 interface SuppressionMiddlewareOptions {
   /**
-  * Called with the recipients that were removed because they are suppressed.
-  * @param suppressed The dropped recipients.
-  */
+   * Called with the recipients that were removed because they are suppressed.
+   * @param suppressed The dropped recipients.
+   */
   onSuppressed?: (suppressed: EmailAddress[]) => void;
 }
 /**
-* Filters suppressed recipients out of the `to` list before sending, and short-circuits with a failed
-* result when every recipient is suppressed.
-* @param store The suppression store to check against.
-* @param options Middleware options. See {@link SuppressionMiddlewareOptions}.
-* @returns A middleware that enforces the suppression list.
-*/
+ * Filters suppressed recipients out of the `to` list before sending, and short-circuits with a failed
+ * result when every recipient is suppressed.
+ * @param store The suppression store to check against.
+ * @param options Middleware options. See {@link SuppressionMiddlewareOptions}.
+ * @returns A middleware that enforces the suppression list.
+ */
 declare const withSuppression: (store: SuppressionStore, options?: SuppressionMiddlewareOptions) => Middleware;
 /**
-* Options for {@link withTelemetry}.
-*/
+ * Options for {@link withTelemetry}.
+ */
 interface TelemetryMiddlewareOptions {
   /**
-  * The span name.
-  * @default "email.send"
-  */
+   * The span name.
+   * @default "email.send"
+   */
   spanName?: string;
 }
 /**
-* Wraps each send in an OpenTelemetry span, recording the provider, recipient count and outcome.
-*
-* The `@opentelemetry/api` `Tracer` is injected (type-only import here), so this middleware adds no
-* runtime dependency — pass `trace.getTracer("email")` from your instrumented app.
-* @param tracer An OpenTelemetry `Tracer`.
-* @param options Middleware options. See {@link TelemetryMiddlewareOptions}.
-* @returns A middleware that traces sends.
-*/
+ * Wraps each send in an OpenTelemetry span, recording the provider, recipient count and outcome.
+ *
+ * The `@opentelemetry/api` `Tracer` is injected (type-only import here), so this middleware adds no
+ * runtime dependency — pass `trace.getTracer("email")` from your instrumented app.
+ * @param tracer An OpenTelemetry `Tracer`.
+ * @param options Middleware options. See {@link TelemetryMiddlewareOptions}.
+ * @returns A middleware that traces sends.
+ */
 declare const withTelemetry: (tracer: Tracer, options?: TelemetryMiddlewareOptions) => Middleware;
 export { type CircuitBreakerMiddlewareOptions, type CircuitState, type DedupeMiddlewareOptions, type EventsMiddlewareOptions, type LoggingMiddlewareOptions, type MetricsMiddlewareOptions, type MetricsRecorder, type Middleware, type OAuth2MiddlewareOptions, type OAuth2Token, RATE_LIMIT_PRESETS, type RateLimitMiddlewareOptions, type RetryMiddlewareOptions, type SuppressionMiddlewareOptions, type TelemetryMiddlewareOptions, circuitBreakerMiddleware, dedupeMiddleware, loggingMiddleware, oauth2Middleware, rateLimitMiddleware, retryMiddleware, withEvents, withMetrics, withRender, withSuppression, withTelemetry };

package/dist/middleware/index.js

@@ -1 +1 @@
-import{circuitBreakerMiddleware as o}from"../packem_shared/circuitBreakerMiddleware-D2SA_07f.js";import{dedupeMiddleware as i}from"../packem_shared/dedupeMiddleware-B6ajWOTi.js";import{withEvents as p}from"../packem_shared/withEvents-CCVblSqj.js";import{loggingMiddleware as f}from"../packem_shared/loggingMiddleware-CZIiVMVp.js";import{withMetrics as w}from"../packem_shared/withMetrics-DWywX_6M.js";import{oauth2Middleware as l}from"../packem_shared/oauth2Middleware-DQh-hIkv.js";import{RATE_LIMIT_PRESETS as h,rateLimitMiddleware as s}from"../packem_shared/RATE_LIMIT_PRESETS-BPADLgcA.js";import{default as c}from"../packem_shared/withRender-VP9wE5Yr.js";import{retryMiddleware as E}from"../packem_shared/retryMiddleware-DbViDX4r.js";import{withSuppression as g}from"../packem_shared/withSuppression-DBaZDMAr.js";import{withTelemetry as S}from"../packem_shared/withTelemetry-DL2qo0Hp.js";import{composeMiddleware as I}from"../packem_shared/composeMiddleware-BHwLLEzK.js";export{h as RATE_LIMIT_PRESETS,o as circuitBreakerMiddleware,I as composeMiddleware,i as dedupeMiddleware,f as loggingMiddleware,l as oauth2Middleware,s as rateLimitMiddleware,E as retryMiddleware,p as withEvents,w as withMetrics,c as withRender,g as withSuppression,S as withTelemetry};
+import{circuitBreakerMiddleware as o}from"../packem_shared/circuitBreakerMiddleware-BSCPR72q.js";import{dedupeMiddleware as i}from"../packem_shared/dedupeMiddleware-CYYI_O7S.js";import{withEvents as p}from"../packem_shared/withEvents-CytsykaK.js";import{loggingMiddleware as f}from"../packem_shared/loggingMiddleware-CZIiVMVp.js";import{withMetrics as w}from"../packem_shared/withMetrics-DWywX_6M.js";import{oauth2Middleware as l}from"../packem_shared/oauth2Middleware-DQh-hIkv.js";import{RATE_LIMIT_PRESETS as h,rateLimitMiddleware as s}from"../packem_shared/RATE_LIMIT_PRESETS-BPADLgcA.js";import{default as c}from"../packem_shared/withRender-VP9wE5Yr.js";import{retryMiddleware as E}from"../packem_shared/retryMiddleware-DbViDX4r.js";import{withSuppression as g}from"../packem_shared/withSuppression-wDl4NTb-.js";import{withTelemetry as S}from"../packem_shared/withTelemetry-DL2qo0Hp.js";import{composeMiddleware as I}from"../packem_shared/composeMiddleware-BHwLLEzK.js";export{h as RATE_LIMIT_PRESETS,o as circuitBreakerMiddleware,I as composeMiddleware,i as dedupeMiddleware,f as loggingMiddleware,l as oauth2Middleware,s as rateLimitMiddleware,E as retryMiddleware,p as withEvents,w as withMetrics,c as withRender,g as withSuppression,S as withTelemetry};

package/dist/packem_shared/{DkimSigner-CiLBaXrg.js → DkimSigner-udCl3JXO.js}

@@ -1,5 +1,5 @@
-import{createRequire as j}from"node:module";import{z as M}from"./index-BoZvzveg.js";import{s as x}from"./headers-to-record-De1Eg951.js";const b=j(import.meta.url),p=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,C=o=>{if(typeof p<"u"&&p.versions&&p.versions.node){const[e,t]=p.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return p.getBuiltinModule(o)}return b(o)},{createHash:h,createPrivateKey:w,sign:T,createSign:v}=C("node:crypto"),_=(o,e="simple")=>{const t=[];for(const[s,a]of Object.entries(o)){const n=e==="relaxed"?s.toLowerCase().trim():s,r=e==="relaxed"?a.replaceAll(/\s+/g," ").trim():a;t.push(`${n}:${r}`)}return t.join(`\r
-`)},z=(o,e="simple")=>{if(e==="simple"){const n=o.replace(/(\r\n|\r|\n)$/,`
+import{createRequire as j}from"node:module";import{q as M}from"./index-y0s2wQdc.js";import{s as x}from"./headers-to-record-De1Eg951.js";let b;const C=o=>(b??=j(import.meta.url))(o),p=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,_=o=>{if(typeof p<"u"&&p.versions&&p.versions.node){const[e,t]=p.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return p.getBuiltinModule(o)}return C(o)},{createHash:h,createPrivateKey:w,sign:T,createSign:v}=_("node:crypto"),q=(o,e="simple")=>{const t=[];for(const[s,a]of Object.entries(o)){const n=e==="relaxed"?s.toLowerCase().trim():s,r=e==="relaxed"?a.replaceAll(/\s+/g," ").trim():a;t.push(`${n}:${r}`)}return t.join(`\r
+`)},I=(o,e="simple")=>{if(e==="simple"){const n=o.replace(/(\r\n|\r|\n)$/,`
 `);let r=n.length;for(;r>0&&n[r-1]===`
 `;)r-=1;const l=n.slice(0,r);return l?`${l}
 `:`
@@ -11,8 +11,8 @@ import{createRequire as j}from"node:module";import{z as M}from"./index-BoZvzveg.
 `);let s=t.length;for(;s>0&&t[s-1]===`
 `;)s-=1;const a=t.slice(0,s);return a?`${a}
 `:`
-`},I=(o,e,t)=>{const s=e.headerCanon??"simple",a=e.bodyCanon??"simple",n=Object.keys(o).filter(r=>!e.headersToIgnore?.some(l=>l.toLowerCase()===r.toLowerCase())).map(r=>r.toLowerCase()).join(":");return["v=1",`a=${e.algorithm??"rsa-sha256"}`,`c=${s}/${a}`,`d=${e.domainName}`,`s=${e.keySelector}`,`h=${n}`,`bh=${t}`,"b="].join("; ")},K=(o,e,t)=>t==="ed25519-sha256"?T(null,h("sha256").update(o).digest(),e).toString("base64"):v("RSA-SHA256").update(o).sign(e,"base64");class i{static sanitizeDisplayName(e){let t=e.replaceAll(/[\r\n\t]+/g," ");t=[...t].filter(n=>{const r=n.codePointAt(0);return r===void 0?!1:r>=32&&r<=126||r>159}).join("");const s="\\",a='"';return t=t.replaceAll(s,s+s).replaceAll(a,s+a),t=t.trim().replaceAll(/\s+/g," "),t}static formatAddress(e){if(e.name){const t=i.sanitizeDisplayName(e.name);return t?`"${t}" <${e.email}>`:e.email}return e.email}static formatAddresses(e){return(Array.isArray(e)?e:[e]).map(t=>i.formatAddress(t)).join(", ")}options;constructor(e){this.options=e}async sign(e){let t=this.options.privateKey;if(t.startsWith("file://")){const c=t.slice(7);t=await M(c,{encoding:"utf8"})}const s={...e.headers?x(e.headers):{},From:i.formatAddress(e.from),To:i.formatAddresses(e.to)};e.cc&&(s.Cc=i.formatAddresses(e.cc)),e.replyTo&&(s["Reply-To"]=i.formatAddress(e.replyTo)),s.Subject=e.subject,s["MIME-Version"]="1.0";const a=[];e.text&&a.push(e.text),e.html&&a.push(e.html);const n=a.join(`
+`},K=(o,e,t)=>{const s=e.headerCanon??"simple",a=e.bodyCanon??"simple",n=Object.keys(o).filter(r=>!e.headersToIgnore?.some(l=>l.toLowerCase()===r.toLowerCase())).map(r=>r.toLowerCase()).join(":");return["v=1",`a=${e.algorithm??"rsa-sha256"}`,`c=${s}/${a}`,`d=${e.domainName}`,`s=${e.keySelector}`,`h=${n}`,`bh=${t}`,"b="].join("; ")},R=(o,e,t)=>t==="ed25519-sha256"?T(null,h("sha256").update(o).digest(),e).toString("base64"):v("RSA-SHA256").update(o).sign(e,"base64");class i{static sanitizeDisplayName(e){let t=e.replaceAll(/[\r\n\t]+/g," ");t=[...t].filter(n=>{const r=n.codePointAt(0);return r===void 0?!1:r>=32&&r<=126||r>159}).join("");const s="\\",a='"';return t=t.replaceAll(s,s+s).replaceAll(a,s+a),t=t.trim().replaceAll(/\s+/g," "),t}static formatAddress(e){if(e.name){const t=i.sanitizeDisplayName(e.name);return t?`"${t}" <${e.email}>`:e.email}return e.email}static formatAddresses(e){return(Array.isArray(e)?e:[e]).map(t=>i.formatAddress(t)).join(", ")}options;constructor(e){this.options=e}async sign(e){let t=this.options.privateKey;if(t.startsWith("file://")){const c=t.slice(7);t=await M(c,{encoding:"utf8"})}const s={...e.headers?x(e.headers):{},From:i.formatAddress(e.from),To:i.formatAddresses(e.to)};e.cc&&(s.Cc=i.formatAddresses(e.cc)),e.replyTo&&(s["Reply-To"]=i.formatAddress(e.replyTo)),s.Subject=e.subject,s["MIME-Version"]="1.0";const a=[];e.text&&a.push(e.text),e.html&&a.push(e.html);const n=a.join(`
 
-`),r=this.options.headerCanon??"simple",l=this.options.bodyCanon??"simple",u=_(s,r),f=z(n,l),g=h("sha256").update(f).digest("base64"),m=I(s,this.options,g),$=`${u}\r
-DKIM-Signature: ${m}`;let d;try{const c=w({key:t,passphrase:this.options.passphrase});d=K($,c,this.options.algorithm)}catch(c){throw new Error(`Failed to create DKIM signature: ${c.message}`)}const y=d.match(/.{1,72}/g)?.join(`\r
- `)??d,A={...s,"DKIM-Signature":`${m}${y}`};return{...e,headers:A}}}const S=o=>new i(o);export{i as DkimSigner,S as createDkimSigner};
+`),r=this.options.headerCanon??"simple",l=this.options.bodyCanon??"simple",u=q(s,r),f=I(n,l),g=h("sha256").update(f).digest("base64"),m=K(s,this.options,g),y=`${u}\r
+DKIM-Signature: ${m}`;let d;try{const c=w({key:t,passphrase:this.options.passphrase});d=R(y,c,this.options.algorithm)}catch(c){throw new Error(`Failed to create DKIM signature: ${c.message}`)}const $=d.match(/.{1,72}/g)?.join(`\r
+ `)??d,A={...s,"DKIM-Signature":`${m}${$}`};return{...e,headers:A}}}const z=o=>new i(o);export{i as DkimSigner,z as createDkimSigner};

package/dist/packem_shared/{DraftMailMessage-CGTVuy2z.js → DraftMailMessage-BgP1OF1G.js}

@@ -1 +1 @@
-import s from"./MailMessage-DQRgs5Dz.js";class r extends s{constructor(){super(),this.header("X-Unsent","1")}}export{r as default};
+import s from"./MailMessage-BRBT4Jea.js";class r extends s{constructor(){super(),this.header("X-Unsent","1")}}export{r as default};

package/dist/packem_shared/EmailError-2CCyVX1S.js

@@ -0,0 +1 @@
+class h extends Error{loc;title;hint;type="VisulimaError";constructor({cause:t,hint:e,location:s,message:a,name:c,stack:o,title:n}){super(a,{cause:t}),this.title=n,this.name=c,this.stack=o??this.stack,this.loc=s,this.hint=e}setLocation(t){this.loc=t}setName(t){this.name=t}setMessage(t){this.message=t}setHint(t){this.hint=t}}let l=class extends h{component;code;constructor(t,e,s){super({cause:s?.cause,hint:s?.hint,message:`[@visulima/email] [${t}] ${e}`,name:"EmailError",title:`Email ${t} Error`}),this.component=t,this.code=s?.code}};export{l as default};

package/dist/packem_shared/Mail-DduRntbB.js

@@ -0,0 +1 @@
+import h from"./DraftMailMessage-BgP1OF1G.js";import v from"./EmailError-2CCyVX1S.js";import f from"./MailMessage-BRBT4Jea.js";import{composeMiddleware as C}from"./composeMiddleware-BHwLLEzK.js";import{j as w}from"./build-mime-message-t8KYiQkO.js";import{c as M}from"./create-logger-BQTS3f-I.js";import{s as g}from"./headers-to-record-De1Eg951.js";import T from"../utils/validation/check-feature-support.js";const S=(i,e,s)=>{e.success&&e.data?i&&i.info("Email sent successfully",{messageId:e.data.messageId,provider:e.data.provider}):i&&i.error("Email send failed",{error:e.error,provider:s})},j=async(i,e,s)=>{const r={...i,to:e.to};return e.cc&&(r.cc=e.cc),e.bcc&&(r.bcc=e.bcc),e.replyTo&&(r.replyTo=e.replyTo),e.headers&&(r.headers={...g(i.headers??{}),...g(e.headers)}),r.subject=e.subject??i.subject,s&&e.data&&(r.subject=await s(r.subject,e.data),i.html!==void 0&&(r.html=await s(i.html,e.data)),i.text!==void 0&&(r.text=await s(i.text,e.data))),r};class u{static extractErrorMessages(e){return e instanceof Error?[e.message]:[String(e??"Unknown error")]}provider;logger;loggerInstance;globalConfig;featureCheck;middlewares=[];composedSend;mountedProviders=new Map;constructor(e,s){this.provider=e,this.featureCheck=s?.featureCheck??"error"}setLogger(e){return this.loggerInstance=e,this.logger=M("Mail",e),this}use(e){return this.middlewares.push(e),this.composedSend=void 0,this}mount(e,s){return this.mountedProviders.set(e,s),this}setFrom(e){return this.globalConfig??={},this.globalConfig.from=e,this.logger&&this.logger.debug("Default from address updated",{from:e.email}),this}setReplyTo(e){return this.globalConfig??={},this.globalConfig.replyTo=e,this.logger&&this.logger.debug("Default reply-to address updated",{replyTo:e.email}),this}setHeaders(e){if(this.globalConfig??={},this.globalConfig.headers=e,this.logger){const s=g(e);this.logger.debug("Default headers updated",{count:Object.keys(s).length,headers:Object.keys(s)})}return this}async draft(e){let s=e instanceof f||e instanceof h?await this.buildDraftFromMessage(e):await this.buildDraftFromOptions(e);s=this.applyGlobalConfig(s);const r=s.headers?g(s.headers):{};s.headers={...r,"X-Unsent":"1"};const t=await w(s,{includeBcc:!0});return this.logger&&this.logger.debug("Draft created successfully in EML format",{from:s.from.email,size:t.length,subject:s.subject,to:Array.isArray(s.to)?s.to.length:1}),t}async send(e){if(e instanceof h)throw new TypeError("Cannot send draft messages. Convert to MailMessage first or remove X-Unsent header.");let s;if(e instanceof f)this.logger&&this.logger.debug("Sending MailMessage instance"),this.loggerInstance&&e.setLogger(this.loggerInstance),s=await e.build();else{const o=e;this.logger&&this.logger.debug("Sending email with options",{subject:o.subject,to:Array.isArray(o.to)?o.to.length:1}),s=o}s=this.applyGlobalConfig(s);const r=this.assertFeatureSupport(s,this.resolveProvider(s));if(r)return{error:r,success:!1};const t=await this.dispatch(s);return S(this.logger,t,this.provider.name??"unknown"),t}sendMany(e,s){const r=Math.max(1,Math.floor(s?.concurrency??1));return r===1?this.sendManySerial(e,s?.signal):this.sendManyConcurrent(e,r,s?.signal)}sendBatch(e,s,r){const t=async function*(){const o=e instanceof f?await e.build():e;for(const a of s)yield await j(o,a,r?.render)};return this.sendMany(t(),{concurrency:r?.concurrency,signal:r?.signal})}async sendOneToReceipt(e){const s=this.provider.name;try{const r=await this.send(e);return r.success&&r.data?{messageId:r.data.messageId,provider:r.data.provider??s,response:r.data.response,successful:!0,timestamp:r.data.timestamp}:{errorMessages:u.extractErrorMessages(r.error),provider:s,successful:!1}}catch(r){return{errorMessages:u.extractErrorMessages(r),provider:s,successful:!1}}}async*sendManySerial(e,s){const r=this.provider.name;let t=0,o=0,a=0;this.logger&&this.logger.debug("Starting batch email send",{provider:r});for await(const l of e){if(l instanceof h)throw new TypeError("Cannot send draft messages. Convert to MailMessage first or remove X-Unsent header.");if(s?.aborted){this.logger&&this.logger.warn("Batch send operation was aborted",{failed:a,processed:t,successful:o}),yield{errorMessages:["Send operation was aborted"],provider:r,successful:!1};return}t+=1;const n=await this.sendOneToReceipt(l);n.successful?o+=1:a+=1,yield n}this.logger&&this.logger.debug("Batch email send completed",{failureCount:a,processedCount:t,provider:r,successCount:o})}async*sendManyConcurrent(e,s,r){const t=this.provider.name;this.logger&&this.logger.debug("Starting concurrent batch email send",{concurrency:s,provider:t});const o=Symbol.asyncIterator in e?e[Symbol.asyncIterator]():e[Symbol.iterator](),a=new Map;let l=0,n=!1,p=!1;const m=async()=>{for(;!n&&!p&&a.size<s;){const d=await o.next();if(d.done){n=!0;break}const c=d.value;if(c instanceof h)throw new TypeError("Cannot send draft messages. Convert to MailMessage first or remove X-Unsent header.");const b=l;l+=1,a.set(b,this.sendOneToReceipt(c).then(y=>({id:b,receipt:y})))}};for(await m();a.size>0;){if(r?.aborted){p=!0,yield{errorMessages:["Send operation was aborted"],provider:t,successful:!1};return}const{id:d,receipt:c}=await Promise.race(a.values());a.delete(d),yield c,await m()}this.logger&&this.logger.debug("Concurrent batch email send completed",{processedCount:l,provider:t})}async dispatch(e){return this.middlewares.length===0?await this.resolveProvider(e).sendEmail(e):(this.composedSend??=C(this.middlewares,s=>Promise.resolve(this.resolveProvider(s).sendEmail(s))),await this.composedSend(e))}resolveProvider(e){return e.stream!==void 0?this.mountedProviders.get(e.stream)??this.provider:this.provider}assertFeatureSupport(e,s){if(this.featureCheck==="off")return;const{supported:r,violations:t}=T(e,s.features);if(r)return;const o=s.name??"unknown",a=t.map(n=>n.field),l=t.map(n=>n.message);if(this.featureCheck==="warn"){this.logger&&this.logger.warn("Message uses capabilities the provider does not support",{fields:a,provider:o});return}return this.logger&&this.logger.error("Message rejected by capability guard",{fields:a,provider:o}),new v(o,`Provider does not support the following message fields: ${a.join(", ")}`,{code:"UNSUPPORTED_FEATURES",hint:l})}async buildDraftFromMessage(e){return this.logger&&this.logger.debug("Creating draft from MailMessage instance"),this.loggerInstance&&e.setLogger(this.loggerInstance),this.applyGlobalConfigToMessage(e),await e.build()}async buildDraftFromOptions(e){return this.logger&&this.logger.debug("Creating draft from email options",{subject:e.subject,to:Array.isArray(e.to)?e.to.length:1}),e}applyGlobalConfigToMessage(e){const s=this.globalConfig?.from;s&&!e.getFrom()&&e.from(s);const r=this.globalConfig?.replyTo;if(r&&!e.getReplyTo()&&e.replyTo(r),this.globalConfig?.headers){const t=g(this.globalConfig.headers);Object.entries(t).forEach(([o,a])=>{e.header(o,a)})}}applyGlobalConfig(e){if(!this.globalConfig)return e;const s={...e};if(!s.from&&this.globalConfig.from&&(s.from=this.globalConfig.from,this.logger&&this.logger.debug("Applied global from address",{from:this.globalConfig.from.email})),!s.replyTo&&this.globalConfig.replyTo&&(s.replyTo=this.globalConfig.replyTo,this.logger&&this.logger.debug("Applied global reply-to address",{replyTo:this.globalConfig.replyTo.email})),this.globalConfig.headers){const r=g(this.globalConfig.headers),t=s.headers?g(s.headers):{};s.headers={...r,...t},this.logger&&this.logger.debug("Merged global headers",{globalCount:Object.keys(r).length,messageCount:Object.keys(t).length})}return s}}const F=(i,e)=>new u(i,e);export{u as Mail,F as createMail};