@visulima/email 1.0.0-alpha.9 → 1.0.0

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

@@ -0,0 +1,199 @@
+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 'node:buffer';
+type StorageValue = null | string | number | boolean | object;
+type WatchEvent = "update" | "remove";
+type WatchCallback = (event: WatchEvent, key: string) => any;
+type MaybePromise<T> = T | Promise<T>;
+type MaybeDefined<T> = T extends any ? T : any;
+type Unwatch = () => MaybePromise<void>;
+interface StorageMeta {
+  atime?: Date;
+  mtime?: Date;
+  ttl?: number;
+  [key: string]: StorageValue | Date | undefined;
+}
+type TransactionOptions = Record<string, any>;
+type GetKeysOptions = TransactionOptions & {
+  maxDepth?: number;
+};
+interface DriverFlags {
+  maxDepth?: boolean;
+  ttl?: boolean;
+}
+interface Driver<OptionsT = any, InstanceT = any> {
+  name?: string;
+  flags?: DriverFlags;
+  options?: OptionsT;
+  getInstance?: () => InstanceT;
+  hasItem: (key: string, opts: TransactionOptions) => MaybePromise<boolean>;
+  getItem: (key: string, opts?: TransactionOptions) => MaybePromise<StorageValue>;
+  /** @experimental */
+  getItems?: (items: {
+    key: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<{
+    key: string;
+    value: StorageValue;
+  }[]>;
+  /** @experimental */
+  getItemRaw?: (key: string, opts: TransactionOptions) => MaybePromise<unknown>;
+  setItem?: (key: string, value: string, opts: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItems?: (items: {
+    key: string;
+    value: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItemRaw?: (key: string, value: any, opts: TransactionOptions) => MaybePromise<void>;
+  removeItem?: (key: string, opts: TransactionOptions) => MaybePromise<void>;
+  getMeta?: (key: string, opts: TransactionOptions) => MaybePromise<StorageMeta | null>;
+  getKeys: (base: string, opts: GetKeysOptions) => MaybePromise<string[]>;
+  clear?: (base: string, opts: TransactionOptions) => MaybePromise<void>;
+  dispose?: () => MaybePromise<void>;
+  watch?: (callback: WatchCallback) => MaybePromise<Unwatch>;
+}
+type StorageDefinition = {
+  items: unknown;
+  [key: string]: unknown;
+};
+type StorageItemMap<T> = T extends StorageDefinition ? T["items"] : T;
+type StorageItemType<T, K> = K extends keyof StorageItemMap<T> ? StorageItemMap<T>[K] : T extends StorageDefinition ? StorageValue : T;
+interface Storage<T extends StorageValue = StorageValue> {
+  hasItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: TransactionOptions): Promise<boolean>;
+  hasItem(key: string, opts?: TransactionOptions): Promise<boolean>;
+  getItem<U extends Extract<T, StorageDefinition>, K extends string & keyof StorageItemMap<U>>(key: K, ops?: TransactionOptions): Promise<StorageItemType<T, K> | null>;
+  getItem<R = StorageItemType<T, string>>(key: string, opts?: TransactionOptions): Promise<R | null>;
+  /** @experimental */
+  getItems: <U extends T>(items: (string | {
+    key: string;
+    options?: TransactionOptions;
+  })[], commonOptions?: TransactionOptions) => Promise<{
+    key: string;
+    value: U;
+  }[]>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  getItemRaw: <T = any>(key: string, opts?: TransactionOptions) => Promise<MaybeDefined<T> | null>;
+  setItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, value: StorageItemType<T, K>, opts?: TransactionOptions): Promise<void>;
+  setItem<U extends T>(key: string, value: U, opts?: TransactionOptions): Promise<void>;
+  /** @experimental */
+  setItems: <U extends T>(items: {
+    key: string;
+    value: U;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => Promise<void>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  setItemRaw: <T = any>(key: string, value: MaybeDefined<T>, opts?: TransactionOptions) => Promise<void>;
+  removeItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  removeItem(key: string, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  getMeta: (key: string, opts?: (TransactionOptions & {
+    nativeOnly?: boolean;
+  }) | boolean) => MaybePromise<StorageMeta>;
+  setMeta: (key: string, value: StorageMeta, opts?: TransactionOptions) => Promise<void>;
+  removeMeta: (key: string, opts?: TransactionOptions) => Promise<void>;
+  getKeys: (base?: string, opts?: GetKeysOptions) => Promise<string[]>;
+  clear: (base?: string, opts?: TransactionOptions) => Promise<void>;
+  dispose: () => Promise<void>;
+  watch: (callback: WatchCallback) => Promise<Unwatch>;
+  unwatch: () => Promise<void>;
+  mount: (base: string, driver: Driver) => Storage;
+  unmount: (base: string, dispose?: boolean) => Promise<void>;
+  getMount: (key?: string) => {
+    base: string;
+    driver: Driver;
+  };
+  getMounts: (base?: string, options?: {
+    parents?: boolean;
+  }) => {
+    base: string;
+    driver: Driver;
+  }[];
+  keys: Storage["getKeys"];
+  get: Storage<T>["getItem"];
+  set: Storage<T>["setItem"];
+  has: Storage<T>["hasItem"];
+  del: Storage<T>["removeItem"];
+  remove: Storage<T>["removeItem"];
+}
+/**
+* Options for {@link UnstorageQueue}.
+*/
+interface UnstorageQueueOptions {
+  /**
+  * Time source in milliseconds — injectable for tests. Defaults to `Date.now`.
+  */
+  now?: () => number;
+  /**
+  * 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
+  */
+  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.
+*/
+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}.
+  */
+  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.
+  */
+  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.
+  */
+  reserve(): Promise<QueueJob | undefined>;
+  /**
+  * 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.
+  */
+  retry(id: string, delayMs?: number): Promise<void>;
+  /**
+  * 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}.
+*/
+declare const createUnstorageQueue: (storage: Storage, options?: UnstorageQueueOptions) => UnstorageQueue;
+export { UnstorageQueue, UnstorageQueueOptions, createUnstorageQueue };

package/dist/queue/unstorage-queue.js

@@ -0,0 +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};

package/dist/render/index.d.ts

@@ -0,0 +1,107 @@
+/**
+* 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).
+*/
+declare const extractCidReferences: (html: string) => string[];
+/**
+* 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 — install it (`pnpm add juice`) to use this. It is loaded
+* lazily (via `createRequire`) so importing the render entry point doesn't fail when `juice` is absent.
+* @param html The HTML email.
+* @param options Options forwarded to `juice` (e.g. `preserveImportant`, `removeStyleTags`).
+* @returns The HTML with CSS inlined.
+* @throws {EmailError} When `juice` is not installed or inlining fails.
+*/
+declare const inlineCss: (html: string, options?: Record<string, unknown>) => string;
+/**
+* Options for {@link addDarkModeSupport}.
+*/
+interface DarkModeOptions {
+  /**
+  * 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 `&lt;head>` (created after `&lt;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;
+/**
+* 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
+  */
+  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 `&lt;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;
+/**
+* Options for {@link postProcessHtml}. Each step runs only when its option is set; the order is
+* CSS-inline → preheader → dark-mode → CID rewrite.
+*/
+interface PostProcessOptions {
+  /**
+  * Rewrite `cid:` references using this resolver (see {@link rewriteCidLinks}).
+  */
+  cidResolver?: (cid: string) => string | undefined;
+  /**
+  * Add dark-mode hooks. `true` adds the meta tags only; an object also injects dark CSS.
+  */
+  darkMode?: DarkModeOptions | boolean;
+  /**
+  * Inline CSS via `juice`. `true` uses defaults; an object forwards options to `juice`.
+  */
+  inlineCss?: Record<string, unknown> | boolean;
+  /**
+  * Inject hidden preview text at the top of the body.
+  */
+  preheader?: string;
+  /**
+  * Options for the preheader injection.
+  */
+  preheaderOptions?: PreheaderOptions;
+}
+/**
+* Runs an HTML email through the selected post-processing steps.
+*
+* A convenience pipeline over {@link inlineCss}, {@link injectPreheader}, {@link addDarkModeSupport} and
+* {@link rewriteCidLinks}. Only the steps whose options are provided run.
+* @param html The HTML email.
+* @param options Which steps to apply. See {@link PostProcessOptions}.
+* @returns The processed HTML.
+*/
+declare const postProcessHtml: (html: string, options?: PostProcessOptions) => string;
+export { type DarkModeOptions, type PostProcessOptions, type PreheaderOptions, addDarkModeSupport, extractCidReferences, injectPreheader, inlineCss, postProcessHtml, rewriteCidLinks };

package/dist/render/index.js

@@ -0,0 +1 @@
+import{extractCidReferences as o,rewriteCidLinks as t}from"../packem_shared/extractCidReferences-BuoTREMp.js";import{default as s}from"../packem_shared/inlineCss-BQ7d2Cyz.js";import{addDarkModeSupport as f}from"../packem_shared/addDarkModeSupport-DZYxULjl.js";import{postProcessHtml as a}from"../packem_shared/postProcessHtml-DqKi2Ucg.js";import{injectPreheader as x}from"../packem_shared/injectPreheader-CF9WHZ7J.js";export{f as addDarkModeSupport,o as extractCidReferences,x as injectPreheader,s as inlineCss,a as postProcessHtml,t as rewriteCidLinks};

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

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

package/dist/template-engines/handlebars.js

@@ -1 +1 @@
-var i=Object.defineProperty;var d=(a,r)=>i(a,"name",{value:r,configurable:!0});import t from"handlebars";import s from"../packem_shared/EmailError-zm2ffVav.js";var o=Object.defineProperty,l=d((a,r)=>o(a,"name",{value:r,configurable:!0}),"s");const p=l((a,r,e)=>{try{if(typeof a!="string")throw new TypeError("Handlebars template must be a string");return t.compile(a,e)(r||{})}catch(n){throw n instanceof Error&&n.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:n}):new s("handlebars",`Failed to render Handlebars template: ${n.message}`,{cause:n})}},"renderHandlebars"),u=l((a,r)=>{try{t.registerHelper(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsHelper"),h=l((a,r)=>{try{t.registerPartial(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsPartial");export{u as registerHandlebarsHelper,h as registerHandlebarsPartial,p as renderHandlebars};
+import t from"handlebars";import s from"../packem_shared/EmailError-B-sEf3bp.js";const i=(a,r,e)=>{try{if(typeof a!="string")throw new TypeError("Handlebars template must be a string");return t.compile(a,e)(r??{})}catch(n){throw n instanceof Error&&n.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:n}):new s("handlebars",`Failed to render Handlebars template: ${n.message}`,{cause:n})}},o=(a,r)=>{try{t.registerHelper(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},c=(a,r)=>{try{t.registerPartial(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}};export{o as registerHandlebarsHelper,c as registerHandlebarsPartial,i as renderHandlebars};

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

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

package/dist/template-engines/html-to-text.js

@@ -1 +1 @@
-var n=Object.defineProperty;var o=(t,e)=>n(t,"name",{value:e,configurable:!0});import{convert as a}from"html-to-text";import l from"../packem_shared/EmailError-zm2ffVav.js";var s=Object.defineProperty,i=o((t,e)=>s(t,"name",{value:e,configurable:!0}),"o");const p=i((t,e)=>{try{return a(t,{longWordSplit:e?.longWordSplit,preserveNewlines:e?.preserveNewlines??!1,selectors:e?.selectors,wordwrap:e?.wordwrap??80})}catch(r){throw r instanceof Error&&r.message.includes("Cannot find module")?new l("html-to-text","html-to-text is not installed. Please install it: pnpm add html-to-text",{cause:r}):new l("html-to-text",`Failed to convert HTML to text: ${r.message}`,{cause:r})}},"htmlToText");export{p as default};
+import{convert as s}from"html-to-text";import o from"../packem_shared/EmailError-B-sEf3bp.js";const a=(r,e)=>{try{return s(r,{longWordSplit:e?.longWordSplit,preserveNewlines:e?.preserveNewlines??!1,selectors:e?.selectors,wordwrap:e?.wordwrap??80})}catch(t){throw t instanceof Error&&t.message.includes("Cannot find module")?new o("html-to-text","html-to-text is not installed. Please install it: pnpm add html-to-text",{cause:t}):new o("html-to-text",`Failed to convert HTML to text: ${t.message}`,{cause:t})}};export{a as default};

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

@@ -0,0 +1,61 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* A map of locale code (e.g. `en`, `en-US`, `de`) to that locale's template.
+*
+* The template value is whatever the underlying {@link TemplateRenderer} accepts (a string for
+* Handlebars/MJML/Liquid, a component for react-email/jsx-email, etc.).
+*/
+type LocaleTemplates = Record<string, unknown>;
+/**
+* Options for {@link renderI18n} and {@link createI18nRenderer}.
+*/
+interface I18nRenderOptions {
+  /**
+  * Locale to fall back to when the requested locale (and its language root) is missing.
+  */
+  defaultLocale?: string;
+  /**
+  * Options forwarded to the underlying renderer.
+  */
+  rendererOptions?: Record<string, unknown>;
+}
+/**
+* Resolves the best-matching available locale key: exact match, then the language subtag
+* (`en-US` → `en`), then the default locale.
+* @param templates The available locale templates.
+* @param locale The requested locale.
+* @param defaultLocale Optional fallback locale.
+* @returns The matching key, or `undefined` when nothing matches.
+*/
+declare const resolveLocale: (templates: LocaleTemplates, locale: string, defaultLocale?: string) => string | undefined;
+/**
+* Renders the template for a given locale using the supplied engine, with locale fallback.
+* @param templates The per-locale templates. See {@link LocaleTemplates}.
+* @param locale The requested locale (e.g. `de-AT`).
+* @param renderer The underlying template engine (Handlebars, MJML, Liquid, react-email, …).
+* @param data Data/variables passed to the renderer.
+* @param options Fallback locale and renderer options. See {@link I18nRenderOptions}.
+* @returns The rendered output for the resolved locale.
+* @throws {EmailError} When no template matches the locale or the fallback.
+*/
+declare const renderI18n: (templates: LocaleTemplates, locale: string, renderer: TemplateRenderer, data?: Record<string, unknown>, options?: I18nRenderOptions) => Promise<string>;
+/**
+* A locale-resolving renderer produced by {@link createI18nRenderer}.
+*/
+type LocalizedRenderer = (templates: LocaleTemplates, locale: string, data?: Record<string, unknown>, rendererOptions?: Record<string, unknown>) => Promise<string>;
+/**
+* Creates a reusable localized renderer bound to an engine and default locale.
+* @param renderer The underlying template engine.
+* @param defaultLocale Optional default/fallback locale applied to every call.
+* @returns A {@link LocalizedRenderer}.
+* @example
+* ```ts
+* import { renderHandlebars } from "@visulima/email/template/handlebars";
+* import { createI18nRenderer } from "@visulima/email/template/i18n";
+*
+* const render = createI18nRenderer(renderHandlebars, "en");
+* await render({ en: "Hello {{name}}", de: "Hallo {{name}}" }, "de", { name: "Ada" });
+* ```
+*/
+declare const createI18nRenderer: (renderer: TemplateRenderer, defaultLocale?: string) => LocalizedRenderer;
+export { I18nRenderOptions, LocaleTemplates, LocalizedRenderer, createI18nRenderer, renderI18n, resolveLocale };

package/dist/template-engines/i18n.js

@@ -0,0 +1 @@
+import l from"../packem_shared/EmailError-B-sEf3bp.js";const c=(t,r,a)=>{const n=new Map(Object.keys(t).map(o=>[o.toLowerCase(),o])),e=o=>{if(o!==void 0)return n.get(o.toLowerCase())};return e(r)??e(r.split("-")[0])??e(a)},d=async(t,r,a,n,e)=>{const o=c(t,r,e?.defaultLocale);if(o===void 0)throw new l("i18n",`No template found for locale "${r}"${e?.defaultLocale?` or default "${e.defaultLocale}"`:""}`);return await a(t[o],n,e?.rendererOptions)},f=(t,r)=>(a,n,e,o)=>d(a,n,t,e,{defaultLocale:r,rendererOptions:o});export{f as createI18nRenderer,d as renderI18n,c as resolveLocale};

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

@@ -0,0 +1,11 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* Renders a [jsx-email](https://jsx.email/) component to HTML.
+* @param template The jsx-email component element to render.
+* @param _data Data object (unused; jsx-email components receive props directly).
+* @param options Render options (`plainText`, `pretty`).
+* @returns The rendered HTML (or plain text) string.
+* @throws {EmailError} When `jsx-email` is not installed or rendering fails.
+*/
+declare const jsxEmail: TemplateRenderer;
+export { jsxEmail as default };

package/dist/template-engines/jsx-email.js

@@ -0,0 +1 @@
+import t from"../packem_shared/EmailError-B-sEf3bp.js";const l=async(n,s,a)=>{try{const{render:e}=await import("jsx-email");return await e(n,{plainText:a?.plainText,pretty:a?.pretty})}catch(e){throw e instanceof Error&&(e.code==="ERR_MODULE_NOT_FOUND"||e.message.includes("Cannot find module")||e.message.includes("Cannot find package"))?new t("jsx-email","jsx-email is not installed. Please install it: pnpm add jsx-email",{cause:e}):new t("jsx-email",`Failed to render jsx-email component: ${e.message}`,{cause:e})}};export{l as default};

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

@@ -0,0 +1,12 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* Renders a [LiquidJS](https://liquidjs.com/) template to a string.
+* @param template The Liquid template string.
+* @param data The data/variables exposed to the template.
+* @param options LiquidJS engine options (passed to the `Liquid` constructor).
+* @returns The rendered output.
+* @throws {TypeError} When the template is not a string.
+* @throws {EmailError} When `liquidjs` is not installed or rendering fails.
+*/
+declare const liquid: TemplateRenderer;
+export { liquid as default };

package/dist/template-engines/liquid.js

@@ -0,0 +1 @@
+import t from"../packem_shared/EmailError-B-sEf3bp.js";const r=async(i,a,n)=>{try{if(typeof i!="string")throw new TypeError("Liquid template must be a string");const{Liquid:e}=await import("liquidjs");return await new e(n??{}).parseAndRender(i,a??{})}catch(e){throw e instanceof TypeError?e:e instanceof Error&&(e.code==="ERR_MODULE_NOT_FOUND"||e.message.includes("Cannot find module")||e.message.includes("Cannot find package"))?new t("liquid","liquidjs is not installed. Please install it: pnpm add liquidjs",{cause:e}):new t("liquid",`Failed to render Liquid template: ${e.message}`,{cause:e})}};export{r as default};

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

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

package/dist/template-engines/mjml.js

@@ -1 +1 @@
-var i=Object.defineProperty;var a=(t,o)=>i(t,"name",{value:o,configurable:!0});import l from"mjml";import r from"../packem_shared/EmailError-zm2ffVav.js";var f=Object.defineProperty,d=a((t,o)=>f(t,"name",{value:o,configurable:!0}),"o");const v=d((t,o,n)=>{try{if(typeof t!="string")throw new TypeError("MJML template must be a string");const e=l(t,{beautify:n?.beautify??!1,fonts:n?.fonts,keepComments:n?.keepComments??!0,minify:n?.minify??!1,validationLevel:n?.validationLevel??"soft"});if(e.errors&&e.errors.length>0){const s=e.errors.map(m=>m.message).join("; ");throw new r("mjml",`MJML validation errors: ${s}`)}return e.html}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new r("mjml","MJML is not installed. Please install it: pnpm add mjml",{cause:e}):e instanceof r?e:new r("mjml",`Failed to render MJML: ${e.message}`,{cause:e})}},"mjml");export{v as default};
+import r from"mjml";import n from"../packem_shared/EmailError-B-sEf3bp.js";const f=(s,i,t)=>{try{if(typeof s!="string")throw new TypeError("MJML template must be a string");const e=r(s,{beautify:t?.beautify??!1,fonts:t?.fonts,keepComments:t?.keepComments??!0,minify:t?.minify??!1,validationLevel:t?.validationLevel??"soft"});if(e.errors&&e.errors.length>0){const o=e.errors.map(a=>a.message).join("; ");throw new n("mjml",`MJML validation errors: ${o}`)}return e.html}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new n("mjml","MJML is not installed. Please install it: pnpm add mjml",{cause:e}):e instanceof n?e:new n("mjml",`Failed to render MJML: ${e.message}`,{cause:e})}};export{f as default};

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

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

package/dist/template-engines/react-email.js

@@ -1 +1 @@
-var l=Object.defineProperty;var n=(e,t)=>l(e,"name",{value:t,configurable:!0});import{render as c}from"@react-email/render";import i from"../packem_shared/EmailError-zm2ffVav.js";var o=Object.defineProperty,m=n((e,t)=>o(e,"name",{value:t,configurable:!0}),"t");const u=m(async(e,t,r)=>{try{return await c(e,{plainText:r?.plainText,pretty:r?.pretty})}catch(a){throw a instanceof Error&&a.message.includes("Cannot find module")?new i("react-email","@react-email/render is not installed. Please install it: pnpm add @react-email/render",{cause:a}):new i("react-email",`Failed to render React Email component: ${a.message}`,{cause:a})}},"reactEmail");export{u as default};
+import{render as n}from"@react-email/render";import a from"../packem_shared/EmailError-B-sEf3bp.js";const s=async(r,i,t)=>{try{return await n(r,{plainText:t?.plainText,pretty:t?.pretty})}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new a("react-email","@react-email/render is not installed. Please install it: pnpm add @react-email/render",{cause:e}):new a("react-email",`Failed to render React Email component: ${e.message}`,{cause:e})}};export{s as default};

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

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

package/dist/template-engines/vue-email.js

@@ -1 +1 @@
-var l=Object.defineProperty;var r=(e,a)=>l(e,"name",{value:a,configurable:!0});import{render as o}from"@vue-email/render";import i from"../packem_shared/EmailError-zm2ffVav.js";var m=Object.defineProperty,s=r((e,a)=>m(e,"name",{value:a,configurable:!0}),"a");const c=s(async(e,a,n)=>{try{return await o(e,a??{},{htmlToTextOptions:n?.htmlToTextOptions,plainText:n?.plainText,pretty:n?.pretty})}catch(t){throw t instanceof Error&&t.message.includes("Cannot find module")?new i("vue-email","@vue-email/render is not installed. Please install it: pnpm add @vue-email/render",{cause:t}):new i("vue-email",`Failed to render Vue Email component: ${t.message}`,{cause:t})}},"vueEmail");export{c as default};
+import{render as i}from"@vue-email/render";import a from"../packem_shared/EmailError-B-sEf3bp.js";const s=async(n,r,t)=>{try{return await i(n,r??{},{htmlToTextOptions:t?.htmlToTextOptions,plainText:t?.plainText,pretty:t?.pretty})}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new a("vue-email","@vue-email/render is not installed. Please install it: pnpm add @vue-email/render",{cause:e}):new a("vue-email",`Failed to render Vue Email component: ${e.message}`,{cause:e})}};export{s as default};