@visulima/email 1.0.1 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## @visulima/email [2.0.0](https://github.com/visulima/visulima/compare/%40visulima%2Femail%401.0.1...%40visulima%2Femail%402.0.0) (2026-07-15)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.2
+
 ## @visulima/email [1.0.1](https://github.com/visulima/visulima/compare/%40visulima%2Femail%401.0.0...%40visulima%2Femail%401.0.1) (2026-07-15)
 
 

package/dist/middleware/index.d.ts

@@ -250,16 +250,17 @@ declare const RATE_LIMIT_PRESETS: {
 declare const rateLimitMiddleware: (options: RateLimitMiddlewareOptions) => Middleware;
 /**
 * Wraps a transform that rewrites the message before it is sent — e.g. running the HTML through the
-* `@visulima/email/render` post-processing pipeline (preheader, CID rewrite, dark-mode, CSS inline).
+* 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 { postProcessHtml } from "@visulima/email/render";
+* import { injectPreheader } from "@visulima/email/render/preheader";
+* import { addDarkModeSupport } from "@visulima/email/render/dark-mode";
 *
 * mail.use(withRender(async (email) => ({
 *   ...email,
-*   html: email.html ? postProcessHtml(email.html, { preheader: "Hi!", darkMode: true }) : email.html,
+*   html: email.html ? addDarkModeSupport(injectPreheader(email.html, "Hi!")) : email.html,
 * })));
 * ```
 */

package/dist/render/cid.d.ts

@@ -0,0 +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.
+*/
+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[];
+export { extractCidReferences, rewriteCidLinks };

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

@@ -0,0 +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.
+*/
+declare const inlineCss: (html: string, options?: Record<string, unknown>) => string;
+export { inlineCss as default };

package/dist/render/css-inline.js

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

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

@@ -0,0 +1,20 @@
+/**
+* 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 `<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

@@ -0,0 +1,24 @@
+/**
+* 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 `<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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/email",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "A comprehensive email library with multi-provider support, crypto utilities, and template engines",
   "keywords": [
     "ahasend",
@@ -63,11 +63,6 @@
   ],
   "homepage": "https://visulima.com/packages/email",
   "bugs": "https://github.com/visulima/visulima/issues",
-  "license": "MIT",
-  "author": {
-    "name": "Daniel Bannert",
-    "email": "d.bannert@anolilab.de"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -83,13 +78,13 @@
       "url": "https://anolilab.com/support"
     }
   ],
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "type": "module",
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
   "sideEffects": false,
+  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -179,9 +174,21 @@
       "types": "./dist/crypto/index.d.ts",
       "default": "./dist/crypto/index.js"
     },
-    "./render": {
-      "types": "./dist/render/index.d.ts",
-      "default": "./dist/render/index.js"
+    "./render/cid": {
+      "types": "./dist/render/cid.d.ts",
+      "default": "./dist/render/cid.js"
+    },
+    "./render/css-inline": {
+      "types": "./dist/render/css-inline.d.ts",
+      "default": "./dist/render/css-inline.js"
+    },
+    "./render/dark-mode": {
+      "types": "./dist/render/dark-mode.d.ts",
+      "default": "./dist/render/dark-mode.js"
+    },
+    "./render/preheader": {
+      "types": "./dist/render/preheader.d.ts",
+      "default": "./dist/render/preheader.js"
     },
     "./webhooks": {
       "types": "./dist/webhooks/index.d.ts",
@@ -353,10 +360,11 @@
     },
     "./package.json": "./package.json"
   },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "dependencies": {
     "html-to-text": "^10.0.0",
     "ical-generator": "11.0.0",
@@ -421,5 +429,9 @@
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   }
 }

package/dist/packem_shared/inlineCss-BQ7d2Cyz.js

@@ -1 +0,0 @@
-import{createRequire as i}from"node:module";import r from"./EmailError-B-sEf3bp.js";const a=i(import.meta.url),n=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,c=o=>{if(typeof n<"u"&&n.versions&&n.versions.node){const[s,t]=n.versions.node.split(".").map(Number);if(s>22||s===22&&t>=3||s===20&&t>=16)return n.getBuiltinModule(o)}return a(o)},{createRequire:u}=c("node:module"),d=u(import.meta.url),p=(o,s)=>{let t;try{const e=d("juice");t=e.default??e}catch(e){throw e instanceof Error&&(e.code==="MODULE_NOT_FOUND"||e.message.includes("Cannot find module")||e.message.includes("Cannot find package"))?new r("render","juice is not installed. Please install it: pnpm add juice",{cause:e}):new r("render",`Failed to load juice: ${e.message}`,{cause:e})}try{return t(o,s)}catch(e){throw new r("render",`Failed to inline CSS: ${e.message}`,{cause:e})}};export{p as default};

package/dist/packem_shared/postProcessHtml-DqKi2Ucg.js

@@ -1 +0,0 @@
-import{rewriteCidLinks as i}from"./extractCidReferences-BuoTREMp.js";import d from"./inlineCss-BQ7d2Cyz.js";import{addDarkModeSupport as t}from"./addDarkModeSupport-DZYxULjl.js";import{injectPreheader as s}from"./injectPreheader-CF9WHZ7J.js";const c=(e,r={})=>{let o=e;return r.inlineCss&&(o=d(o,typeof r.inlineCss=="object"?r.inlineCss:void 0)),r.preheader!==void 0&&(o=s(o,r.preheader,r.preheaderOptions)),r.darkMode&&(o=t(o,typeof r.darkMode=="object"?r.darkMode:void 0)),r.cidResolver&&(o=i(o,r.cidResolver)),o};export{c as postProcessHtml};

package/dist/render/index.d.ts

@@ -1,107 +0,0 @@
-/**
-* 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

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