@visulima/email 2.1.6 → 2.1.7

package/dist/queue/index.d.ts

@@ -1,147 +1,147 @@
-import { E as EmailOptions, a as EmailResult, R as Result } from "../packem_shared/types.d-ejzh-xBP.js";
-import { E as EnqueueOptions, Q as QueueJob, a as EmailQueue } from "../packem_shared/types.d-lcJZmwRK.js";
+import { E as EmailOptions, a as EmailResult, R as Result } from "../packem_shared/types.d-B9295M4_.js";
+import { E as EnqueueOptions, Q as QueueJob, a as EmailQueue } from "../packem_shared/types.d-kHO4kX9q.js";
 export { UnstorageQueue, type UnstorageQueueOptions, createUnstorageQueue } from "./unstorage-queue.js";
 import 'node:buffer';
 /**
-* Options for {@link MemoryQueue}.
-*/
+ * Options for {@link MemoryQueue}.
+ */
 interface MemoryQueueOptions {
   /**
-  * 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 reserved job stays hidden before it becomes deliverable again
-  * (in case the worker crashed mid-process).
-  * @default 30000
-  */
+   * How long, in milliseconds, a reserved job stays hidden before it becomes deliverable again
+   * (in case the worker crashed mid-process).
+   * @default 30000
+   */
   visibilityTimeout?: number;
 }
 /**
-* An in-memory {@link EmailQueue} with `scheduledAt` support and a reservation visibility timeout.
-*
-* Suitable for tests, single-process apps, and as a reference for adapter authors. Jobs do not survive
-* a process restart — use a durable adapter in production.
-*/
+ * An in-memory {@link EmailQueue} with `scheduledAt` support and a reservation visibility timeout.
+ *
+ * Suitable for tests, single-process apps, and as a reference for adapter authors. Jobs do not survive
+ * a process restart — use a durable adapter in production.
+ */
 declare class MemoryQueue implements EmailQueue {
   private readonly jobs;
   private readonly visibilityTimeout;
   private readonly now;
   private sequence;
   /**
-  * @param options Queue options. See {@link MemoryQueueOptions}.
-  */
+   * @param options Queue options. See {@link MemoryQueueOptions}.
+   */
   constructor(options?: MemoryQueueOptions);
   /**
-  * Adds a message to the queue.
-  * @param message The message to send later.
-  * @param options Optional scheduling. See {@link EnqueueOptions}.
-  * @returns The new job id.
-  */
+   * Adds a message to the queue.
+   * @param message The message to send later.
+   * @param options Optional scheduling. See {@link EnqueueOptions}.
+   * @returns The new job id.
+   */
   enqueue(message: EmailOptions, options?: EnqueueOptions): string;
   /**
-  * Reserves the next ready job, hiding it for the visibility window.
-  * @returns The next deliverable job, or `undefined` when none is ready.
-  */
+   * Reserves the next ready job, hiding it for the visibility window.
+   * @returns The next deliverable job, or `undefined` when none is ready.
+   */
   reserve(): QueueJob | undefined;
   /**
-  * Marks a reserved job as processed and removes it.
-  * @param id The job id.
-  */
+   * Marks a reserved job as processed and removes it.
+   * @param id The job id.
+   */
   ack(id: string): void;
   /**
-  * Returns a job to the queue after a delay, incrementing its attempt count.
-  * @param id The job id.
-  * @param delayMs Milliseconds to wait before the job becomes ready again.
-  */
+   * Returns a job to the queue after a delay, incrementing its attempt count.
+   * @param id The job id.
+   * @param delayMs Milliseconds to wait before the job becomes ready again.
+   */
   retry(id: string, delayMs?: number): void;
   /**
-  * Reports how many jobs remain (ready plus reserved).
-  * @returns The count of ready and reserved jobs.
-  */
+   * Reports how many jobs remain (ready plus reserved).
+   * @returns The count of ready and reserved jobs.
+   */
   size(): number;
 }
 /**
-* Options for {@link createWorker}.
-*/
+ * Options for {@link createWorker}.
+ */
 interface WorkerOptions {
   /**
-  * Retry backoff: returns the delay (ms) before re-attempting after `attempts` failures.
-  * @default attempts => 1000 * 2 ** (attempts - 1)
-  */
+   * Retry backoff: returns the delay (ms) before re-attempting after `attempts` failures.
+   * @default attempts => 1000 * 2 ** (attempts - 1)
+   */
   backoff?: (attempts: number) => number;
   /**
-  * How many jobs to process concurrently.
-  * @default 1
-  */
+   * How many jobs to process concurrently.
+   * @default 1
+   */
   concurrency?: number;
   /**
-  * Maximum delivery attempts before a job is dead-lettered.
-  * @default 3
-  */
+   * Maximum delivery attempts before a job is dead-lettered.
+   * @default 3
+   */
   maxAttempts?: number;
   /**
-  * Called when a job exhausts its attempts and is dropped.
-  * @param job The dead-lettered job.
-  * @param result The final failed result.
-  */
+   * Called when a job exhausts its attempts and is dropped.
+   * @param job The dead-lettered job.
+   * @param result The final failed result.
+   */
   onDeadLetter?: (job: QueueJob, result: Result<EmailResult>) => void;
   /**
-  * Called on every failed attempt (before any retry).
-  * @param job The job that failed.
-  * @param result The failed result (or thrown error wrapped).
-  */
+   * Called on every failed attempt (before any retry).
+   * @param job The job that failed.
+   * @param result The failed result (or thrown error wrapped).
+   */
   onError?: (job: QueueJob, result: Result<EmailResult>) => void;
   /**
-  * Called when `queue.reserve()` itself rejects (e.g. a transient store error). The poll loop keeps
-  * running regardless; this hook just surfaces the failure.
-  * @param error The reserve error.
-  */
+   * Called when `queue.reserve()` itself rejects (e.g. a transient store error). The poll loop keeps
+   * running regardless; this hook just surfaces the failure.
+   * @param error The reserve error.
+   */
   onReserveError?: (error: Error) => void;
   /**
-  * Idle poll interval, in milliseconds, when no job is ready.
-  * @default 1000
-  */
+   * Idle poll interval, in milliseconds, when no job is ready.
+   * @default 1000
+   */
   pollInterval?: number;
   /**
-  * The queue to consume.
-  */
+   * The queue to consume.
+   */
   queue: EmailQueue;
   /**
-  * The send function — typically `mail.send.bind(mail)`.
-  */
+   * The send function — typically `mail.send.bind(mail)`.
+   */
   send: (message: EmailOptions) => Promise<Result<EmailResult>>;
 }
 /**
-* A running queue worker.
-*/
+ * A running queue worker.
+ */
 interface Worker {
   /**
-  * Processes ready jobs until the queue has none currently deliverable, then resolves.
-  *
-  * Does not wait for future-scheduled jobs. Useful in tests and one-shot drains.
-  */
+   * Processes ready jobs until the queue has none currently deliverable, then resolves.
+   *
+   * Does not wait for future-scheduled jobs. Useful in tests and one-shot drains.
+   */
   drain: () => Promise<void>;
   /**
-  * Begins polling and processing jobs in the background.
-  */
+   * Begins polling and processing jobs in the background.
+   */
   start: () => void;
   /**
-  * Stops polling. In-flight jobs are allowed to finish.
-  */
+   * Stops polling. In-flight jobs are allowed to finish.
+   */
   stop: () => void;
 }
 /**
-* Creates a worker that durably processes queued messages with bounded concurrency, retry/backoff, and
-* dead-lettering.
-* @param options Worker configuration. See {@link WorkerOptions}.
-* @returns The worker handle. See {@link Worker}.
-* @example
-* ```ts
-* const queue = new MemoryQueue();
-* const worker = createWorker({ queue, send: mail.send.bind(mail), concurrency: 5 });
-* worker.start();
-* ```
-*/
+ * Creates a worker that durably processes queued messages with bounded concurrency, retry/backoff, and
+ * dead-lettering.
+ * @param options Worker configuration. See {@link WorkerOptions}.
+ * @returns The worker handle. See {@link Worker}.
+ * @example
+ * ```ts
+ * const queue = new MemoryQueue();
+ * const worker = createWorker({ queue, send: mail.send.bind(mail), concurrency: 5 });
+ * worker.start();
+ * ```
+ */
 declare const createWorker: (options: WorkerOptions) => Worker;
 export { type EmailQueue, type EnqueueOptions, MemoryQueue, type MemoryQueueOptions, type QueueJob, type Worker, type WorkerOptions, createWorker };

package/dist/queue/pg-boss-queue.d.ts

@@ -1,5 +1,5 @@
-import { a as EmailQueue } from "../packem_shared/types.d-lcJZmwRK.js";
-import "../packem_shared/types.d-ejzh-xBP.js";
+import { a as EmailQueue } from "../packem_shared/types.d-kHO4kX9q.js";
+import "../packem_shared/types.d-B9295M4_.js";
 import 'node:buffer';
 interface PgBossJob {
   data: unknown;
@@ -8,8 +8,8 @@ interface PgBossJob {
   retryCount?: number;
 }
 /**
-* The subset of a [pg-boss](https://github.com/timgit/pg-boss) instance this adapter uses (v10 API).
-*/
+ * The subset of a [pg-boss](https://github.com/timgit/pg-boss) instance this adapter uses (v10 API).
+ */
 interface PgBossLike {
   complete: (name: string, id: string) => Promise<unknown>;
   fail: (name: string, id: string) => Promise<unknown>;
@@ -23,19 +23,19 @@ interface PgBossLike {
   }) => Promise<null | string>;
 }
 /**
-* Options for {@link createPgBossQueue}.
-*/
+ * Options for {@link createPgBossQueue}.
+ */
 interface PgBossQueueOptions {
   /**
-  * The pg-boss queue name.
-  */
+   * The pg-boss queue name.
+   */
   queueName: string;
 }
 /**
-* Creates an {@link EmailQueue} backed by pg-boss.
-* @param boss A started pg-boss instance (optional peer).
-* @param options Queue options. See {@link PgBossQueueOptions}.
-* @returns The pg-boss-backed queue.
-*/
+ * Creates an {@link EmailQueue} backed by pg-boss.
+ * @param boss A started pg-boss instance (optional peer).
+ * @param options Queue options. See {@link PgBossQueueOptions}.
+ * @returns The pg-boss-backed queue.
+ */
 declare const createPgBossQueue: (boss: PgBossLike, options: PgBossQueueOptions) => EmailQueue;
 export { type PgBossLike, type PgBossQueueOptions, createPgBossQueue };

package/dist/queue/sqs-queue.d.ts

@@ -1,10 +1,10 @@
-import { a as EmailQueue } from "../packem_shared/types.d-lcJZmwRK.js";
-import "../packem_shared/types.d-ejzh-xBP.js";
+import { a as EmailQueue } from "../packem_shared/types.d-kHO4kX9q.js";
+import "../packem_shared/types.d-B9295M4_.js";
 import 'node:buffer';
 /**
-* The subset of the `@aws-sdk/client-sqs` `SQS` client this adapter uses. The `SQS` class (not the
-* lower-level `SQSClient`) exposes these operation methods directly.
-*/
+ * The subset of the `@aws-sdk/client-sqs` `SQS` client this adapter uses. The `SQS` class (not the
+ * lower-level `SQSClient`) exposes these operation methods directly.
+ */
 interface SqsClientLike {
   changeMessageVisibility: (input: {
     QueueUrl: string;
@@ -44,29 +44,29 @@ interface SqsClientLike {
   }>;
 }
 /**
-* Options for {@link createSqsQueue}.
-*/
+ * Options for {@link createSqsQueue}.
+ */
 interface SqsQueueOptions {
   /**
-  * The SQS queue URL.
-  */
+   * The SQS queue URL.
+   */
   queueUrl: string;
   /**
-  * Visibility timeout (seconds) applied when reserving a message.
-  * @default 30
-  */
+   * Visibility timeout (seconds) applied when reserving a message.
+   * @default 30
+   */
   visibilityTimeout?: number;
   /**
-  * Long-poll wait time (seconds) for `reserve`.
-  * @default 0
-  */
+   * Long-poll wait time (seconds) for `reserve`.
+   * @default 0
+   */
   waitTimeSeconds?: number;
 }
 /**
-* Creates an {@link EmailQueue} backed by Amazon SQS.
-* @param client An `@aws-sdk/client-sqs` `SQS` instance (optional peer).
-* @param options Queue options. See {@link SqsQueueOptions}.
-* @returns The SQS-backed queue.
-*/
+ * Creates an {@link EmailQueue} backed by Amazon SQS.
+ * @param client An `@aws-sdk/client-sqs` `SQS` instance (optional peer).
+ * @param options Queue options. See {@link SqsQueueOptions}.
+ * @returns The SQS-backed queue.
+ */
 declare const createSqsQueue: (client: SqsClientLike, options: SqsQueueOptions) => EmailQueue;
 export { type SqsClientLike, type SqsQueueOptions, createSqsQueue };

package/dist/queue/unstorage-queue.d.ts

@@ -1,5 +1,5 @@
-import { E as EmailOptions } from "../packem_shared/types.d-ejzh-xBP.js";
-import { E as EnqueueOptions, Q as QueueJob, a as EmailQueue } from "../packem_shared/types.d-lcJZmwRK.js";
+import { E as EmailOptions } from "../packem_shared/types.d-B9295M4_.js";
+import { E as EnqueueOptions, Q as QueueJob, a as EmailQueue } from "../packem_shared/types.d-kHO4kX9q.js";
 import 'node:buffer';
 type StorageValue = null | string | number | boolean | object;
 type WatchEvent = "update" | "remove";
@@ -121,79 +121,79 @@ interface Storage<T extends StorageValue = StorageValue> {
   remove: Storage<T>["removeItem"];
 }
 /**
-* Options for {@link UnstorageQueue}.
-*/
+ * Options for {@link UnstorageQueue}.
+ */
 interface UnstorageQueueOptions {
   /**
-  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
-  */
+   * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+   */
   now?: () => number;
   /**
-  * Key prefix under which jobs are stored.
-  * @default "email:queue"
-  */
+   * Key prefix under which jobs are stored.
+   * @default "email:queue"
+   */
   prefix?: string;
   /**
-  * How long, in milliseconds, a reserved job stays hidden before becoming deliverable again.
-  * @default 30000
-  */
+   * How long, in milliseconds, a reserved job stays hidden before becoming deliverable again.
+   * @default 30000
+   */
   visibilityTimeout?: number;
 }
 /**
-* A durable {@link EmailQueue} backed by an [unstorage](https://unstorage.unjs.io/) `Storage`.
-*
-* Because unstorage abstracts many backends (memory, filesystem, Redis, Cloudflare KV, Postgres, …),
-* a single adapter persists the queue across all of them. The stored `message` must be
-* JSON-serializable (avoid `Buffer` attachments — pass `path`/`href`/base64 `content` instead).
-*
-* Note: unstorage has no transactions, so {@link UnstorageQueue.reserve} is best-effort under
-* concurrent workers; the visibility timeout bounds duplicate delivery on a crash.
-*/
+ * A durable {@link EmailQueue} backed by an [unstorage](https://unstorage.unjs.io/) `Storage`.
+ *
+ * Because unstorage abstracts many backends (memory, filesystem, Redis, Cloudflare KV, Postgres, …),
+ * a single adapter persists the queue across all of them. The stored `message` must be
+ * JSON-serializable (avoid `Buffer` attachments — pass `path`/`href`/base64 `content` instead).
+ *
+ * Note: unstorage has no transactions, so {@link UnstorageQueue.reserve} is best-effort under
+ * concurrent workers; the visibility timeout bounds duplicate delivery on a crash.
+ */
 declare class UnstorageQueue implements EmailQueue {
   private readonly storage;
   private readonly prefix;
   private readonly visibilityTimeout;
   private readonly now;
   /**
-  * @param storage The unstorage instance to persist jobs in.
-  * @param options Adapter options. See {@link UnstorageQueueOptions}.
-  */
+   * @param storage The unstorage instance to persist jobs in.
+   * @param options Adapter options. See {@link UnstorageQueueOptions}.
+   */
   constructor(storage: Storage, options?: UnstorageQueueOptions);
   /**
-  * Persists a message to the store.
-  * @param message The message to send later.
-  * @param options Optional scheduling. See {@link EnqueueOptions}.
-  * @returns The new job id.
-  */
+   * Persists a message to the store.
+   * @param message The message to send later.
+   * @param options Optional scheduling. See {@link EnqueueOptions}.
+   * @returns The new job id.
+   */
   enqueue(message: EmailOptions, options?: EnqueueOptions): Promise<string>;
   /**
-  * Reserves the next ready job, hiding it for the visibility window.
-  * @returns The next deliverable job, or `undefined` when none is ready.
-  */
+   * Reserves the next ready job, hiding it for the visibility window.
+   * @returns The next deliverable job, or `undefined` when none is ready.
+   */
   reserve(): Promise<QueueJob | undefined>;
   /**
-  * Removes a processed job from the store.
-  * @param id The job id.
-  */
+   * Removes a processed job from the store.
+   * @param id The job id.
+   */
   ack(id: string): Promise<void>;
   /**
-  * Requeues a job after a delay, incrementing its attempt count.
-  * @param id The job id.
-  * @param delayMs Milliseconds to wait before the job becomes ready again.
-  */
+   * Requeues a job after a delay, incrementing its attempt count.
+   * @param id The job id.
+   * @param delayMs Milliseconds to wait before the job becomes ready again.
+   */
   retry(id: string, delayMs?: number): Promise<void>;
   /**
-  * Counts the jobs currently in the store.
-  * @returns The number of stored (ready plus reserved) jobs.
-  */
+   * Counts the jobs currently in the store.
+   * @returns The number of stored (ready plus reserved) jobs.
+   */
   size(): Promise<number>;
   private keyOf;
 }
 /**
-* Creates an {@link UnstorageQueue}.
-* @param storage The unstorage instance to persist jobs in.
-* @param options Adapter options. See {@link UnstorageQueueOptions}.
-* @returns A new {@link UnstorageQueue}.
-*/
+ * Creates an {@link UnstorageQueue}.
+ * @param storage The unstorage instance to persist jobs in.
+ * @param options Adapter options. See {@link UnstorageQueueOptions}.
+ * @returns A new {@link UnstorageQueue}.
+ */
 declare const createUnstorageQueue: (storage: Storage, options?: UnstorageQueueOptions) => UnstorageQueue;
 export { UnstorageQueue, UnstorageQueueOptions, createUnstorageQueue };

package/dist/queue/unstorage-queue.js

@@ -1 +1 @@
-import{createRequire as n}from"node:module";const c=n(import.meta.url),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=r=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[e,s]=o.versions.node.split(".").map(Number);if(e>22||e===22&&s>=3||e===20&&s>=16)return o.getBuiltinModule(r)}return c(r)},{randomUUID:d}=u("node:crypto");class h{storage;prefix;visibilityTimeout;now;constructor(e,s={}){this.storage=e,this.prefix=s.prefix??"email:queue",this.visibilityTimeout=s.visibilityTimeout??3e4,this.now=s.now??Date.now}async enqueue(e,s={}){const i=d(),t=s.scheduledAt instanceof Date?s.scheduledAt.getTime():s.scheduledAt??this.now(),a={attempts:0,id:i,message:e,reservedUntil:0,scheduledAt:t};return await this.storage.setItem(this.keyOf(i),a),i}async reserve(){const e=this.now(),s=await this.storage.getKeys(this.prefix);for(const i of s){const t=await this.storage.getItem(i);if(t&&t.scheduledAt<=e&&t.reservedUntil<=e)return t.reservedUntil=e+this.visibilityTimeout,await this.storage.setItem(i,t),{attempts:t.attempts,id:t.id,message:t.message,scheduledAt:t.scheduledAt}}}async ack(e){await this.storage.removeItem(this.keyOf(e))}async retry(e,s=0){const i=this.keyOf(e),t=await this.storage.getItem(i);t&&(t.attempts+=1,t.reservedUntil=0,t.scheduledAt=this.now()+s,await this.storage.setItem(i,t))}async size(){return(await this.storage.getKeys(this.prefix)).length}keyOf(e){return`${this.prefix}:${e}`}}const m=(r,e)=>new h(r,e);export{h as UnstorageQueue,m as createUnstorageQueue};
+import{createRequire as n}from"node:module";let c;const u=r=>(c??=n(import.meta.url))(r),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,d=r=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[e,s]=o.versions.node.split(".").map(Number);if(e>22||e===22&&s>=3||e===20&&s>=16)return o.getBuiltinModule(r)}return u(r)},{randomUUID:h}=d("node:crypto");class l{storage;prefix;visibilityTimeout;now;constructor(e,s={}){this.storage=e,this.prefix=s.prefix??"email:queue",this.visibilityTimeout=s.visibilityTimeout??3e4,this.now=s.now??Date.now}async enqueue(e,s={}){const i=h(),t=s.scheduledAt instanceof Date?s.scheduledAt.getTime():s.scheduledAt??this.now(),a={attempts:0,id:i,message:e,reservedUntil:0,scheduledAt:t};return await this.storage.setItem(this.keyOf(i),a),i}async reserve(){const e=this.now(),s=await this.storage.getKeys(this.prefix);for(const i of s){const t=await this.storage.getItem(i);if(t&&t.scheduledAt<=e&&t.reservedUntil<=e)return t.reservedUntil=e+this.visibilityTimeout,await this.storage.setItem(i,t),{attempts:t.attempts,id:t.id,message:t.message,scheduledAt:t.scheduledAt}}}async ack(e){await this.storage.removeItem(this.keyOf(e))}async retry(e,s=0){const i=this.keyOf(e),t=await this.storage.getItem(i);t&&(t.attempts+=1,t.reservedUntil=0,t.scheduledAt=this.now()+s,await this.storage.setItem(i,t))}async size(){return(await this.storage.getKeys(this.prefix)).length}keyOf(e){return`${this.prefix}:${e}`}}const g=(r,e)=>new l(r,e);export{l as UnstorageQueue,g as createUnstorageQueue};

package/dist/render/cid.d.ts

@@ -1,17 +1,17 @@
 /**
-* Rewrites `cid:` references in `src`/`href` attributes using a resolver.
-*
-* Useful for turning inline (Content-ID) image references into hosted URLs for previews/webmail, or
-* for normalizing them. Returning `undefined` from the resolver leaves that reference unchanged.
-* @param html The HTML email.
-* @param resolver Maps a Content-ID to a replacement URL (or `undefined` to keep it).
-* @returns The rewritten HTML.
-*/
+ * Rewrites `cid:` references in `src`/`href` attributes using a resolver.
+ *
+ * Useful for turning inline (Content-ID) image references into hosted URLs for previews/webmail, or
+ * for normalizing them. Returning `undefined` from the resolver leaves that reference unchanged.
+ * @param html The HTML email.
+ * @param resolver Maps a Content-ID to a replacement URL (or `undefined` to keep it).
+ * @returns The rewritten HTML.
+ */
 declare const rewriteCidLinks: (html: string, resolver: (cid: string) => string | undefined) => string;
 /**
-* Collects the Content-IDs referenced via `cid:` in `src`/`href` attributes.
-* @param html The HTML email.
-* @returns The referenced Content-IDs (de-duplicated, in first-seen order).
-*/
+ * Collects the Content-IDs referenced via `cid:` in `src`/`href` attributes.
+ * @param html The HTML email.
+ * @returns The referenced Content-IDs (de-duplicated, in first-seen order).
+ */
 declare const extractCidReferences: (html: string) => string[];
 export { extractCidReferences, rewriteCidLinks };

package/dist/render/css-inline.d.ts

@@ -1,15 +1,15 @@
 /**
-* Inlines `<style>`/linked CSS into element `style` attributes for maximum email-client
-* compatibility, via [juice](https://github.com/Automattic/juice).
-*
-* `juice` is an optional peer dependency, and this helper is published as its own subpath
-* (`@visulima/email/render/css-inline`). Importing this module resolves `juice` eagerly, so install
-* it (`pnpm add juice`) before importing — consumers who never inline CSS simply never import this
-* entry, which keeps `juice` out of edge/worker bundles.
-* @param html The HTML email.
-* @param options Options forwarded to `juice` (e.g. `preserveImportant`, `removeStyleTags`).
-* @returns The HTML with CSS inlined.
-* @throws {EmailError} When inlining fails.
-*/
+ * Inlines `<style>`/linked CSS into element `style` attributes for maximum email-client
+ * compatibility, via [juice](https://github.com/Automattic/juice).
+ *
+ * `juice` is an optional peer dependency, and this helper is published as its own subpath
+ * (`@visulima/email/render/css-inline`). Importing this module resolves `juice` eagerly, so install
+ * it (`pnpm add juice`) before importing — consumers who never inline CSS simply never import this
+ * entry, which keeps `juice` out of edge/worker bundles.
+ * @param html The HTML email.
+ * @param options Options forwarded to `juice` (e.g. `preserveImportant`, `removeStyleTags`).
+ * @returns The HTML with CSS inlined.
+ * @throws {EmailError} When inlining fails.
+ */
 declare const inlineCss: (html: string, options?: Record<string, unknown>) => string;
 export { inlineCss as default };

package/dist/render/css-inline.js

@@ -1 +1 @@
-import t from"juice";import n from"../packem_shared/EmailError-B-sEf3bp.js";const i=(r,o)=>{const a=t.default??t;try{return a(r,o)}catch(e){throw new n("render",`Failed to inline CSS: ${e.message}`,{cause:e})}};export{i as default};
+import t from"juice";import n from"../packem_shared/EmailError-CDvYwuqz.js";const i=(r,o)=>{const a=t.default??t;try{return a(r,o)}catch(e){throw new n("render",`Failed to inline CSS: ${e.message}`,{cause:e})}};export{i as default};

package/dist/render/dark-mode.d.ts

@@ -1,20 +1,20 @@
 /**
-* Options for {@link addDarkModeSupport}.
-*/
+ * Options for {@link addDarkModeSupport}.
+ */
 interface DarkModeOptions {
   /**
-  * Extra CSS to wrap in a `@media (prefers-color-scheme: dark)` block (the dark-mode overrides).
-  */
+   * Extra CSS to wrap in a `@media (prefers-color-scheme: dark)` block (the dark-mode overrides).
+   */
   styles?: string;
 }
 /**
-* Adds dark-mode hooks to an HTML email: the `color-scheme` / `supported-color-schemes` meta tags and,
-* when provided, a `@media (prefers-color-scheme: dark)` style block.
-*
-* Injected into `<head>` (created after `<html>` if absent, otherwise prepended).
-* @param html The HTML email.
-* @param options Dark-mode options. See {@link DarkModeOptions}.
-* @returns The HTML with dark-mode support added.
-*/
+ * Adds dark-mode hooks to an HTML email: the `color-scheme` / `supported-color-schemes` meta tags and,
+ * when provided, a `@media (prefers-color-scheme: dark)` style block.
+ *
+ * Injected into `<head>` (created after `<html>` if absent, otherwise prepended).
+ * @param html The HTML email.
+ * @param options Dark-mode options. See {@link DarkModeOptions}.
+ * @returns The HTML with dark-mode support added.
+ */
 declare const addDarkModeSupport: (html: string, options?: DarkModeOptions) => string;
 export { DarkModeOptions, addDarkModeSupport };

package/dist/render/preheader.d.ts

@@ -1,24 +1,24 @@
 /**
-* Options for {@link injectPreheader}.
-*/
+ * Options for {@link injectPreheader}.
+ */
 interface PreheaderOptions {
   /**
-  * Append invisible padding characters so the preheader text isn't followed by leaked body content
-  * in the inbox preview.
-  * @default true
-  */
+   * Append invisible padding characters so the preheader text isn't followed by leaked body content
+   * in the inbox preview.
+   * @default true
+   */
   spacer?: boolean;
 }
 /**
-* Injects a hidden preheader (inbox preview text) at the start of the HTML body.
-*
-* The preheader is wrapped in a `display:none` element with `mso-hide:all`, followed by zero-width
-* padding so the preview shows only your text. Inserted right after `<body>` (or prepended if no
-* body tag is present).
-* @param html The HTML email.
-* @param preheader The preview text.
-* @param options Injection options. See {@link PreheaderOptions}.
-* @returns The HTML with the preheader injected.
-*/
+ * Injects a hidden preheader (inbox preview text) at the start of the HTML body.
+ *
+ * The preheader is wrapped in a `display:none` element with `mso-hide:all`, followed by zero-width
+ * padding so the preview shows only your text. Inserted right after `<body>` (or prepended if no
+ * body tag is present).
+ * @param html The HTML email.
+ * @param preheader The preview text.
+ * @param options Injection options. See {@link PreheaderOptions}.
+ * @returns The HTML with the preheader injected.
+ */
 declare const injectPreheader: (html: string, preheader: string, options?: PreheaderOptions) => string;
 export { PreheaderOptions, injectPreheader };