@emailens/engine 0.6.0 → 0.8.0

package/dist/{react-email-BQljgXbo.d.ts → types-4P9AtKm_.d.ts}

@@ -174,6 +174,8 @@ interface SpamReport {
 interface SpamAnalysisOptions {
     /** Value of the List-Unsubscribe header, if present */
     listUnsubscribeHeader?: string;
+    /** Value of the List-Unsubscribe-Post header (RFC 8058 one-click unsubscribe) */
+    listUnsubscribePostHeader?: string;
     /** Type of email — transactional emails are exempt from unsubscribe requirements */
     emailType?: "marketing" | "transactional";
 }
@@ -230,60 +232,69 @@ interface ImageReport {
     issues: ImageIssue[];
     images: ImageInfo[];
 }
-
-/**
- * Unified error class for all email compilation failures.
- *
- * Replaces the per-format error classes (ReactEmailCompileError,
- * MjmlCompileError, MaizzleCompileError) with a single class that
- * carries the source format and failure phase.
- */
-declare class CompileError extends Error {
-    name: string;
-    readonly format: Exclude<InputFormat, "html">;
-    readonly phase: "validation" | "transpile" | "execution" | "render" | "compile";
-    constructor(message: string, format: CompileError["format"], phase: CompileError["phase"]);
+interface InboxPreviewIssue {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
 }
-
-/**
- * Sandbox strategy for JSX execution.
- *
- * - `"vm"` — `node:vm` with hardened globals. Fast, zero-dependency,
- *   but NOT a true security boundary (prototype-chain escapes are possible).
- *   Suitable for CLI / local use where users run their own code.
- *
- * - `"isolated-vm"` (default) — Separate V8 isolate via the `isolated-vm`
- *   npm package. True heap isolation; escapes require a V8 engine bug.
- *   Requires `isolated-vm` to be installed (native addon).
- *
- * - `"quickjs"` — Validates code structure in a QuickJS WASM sandbox, then
- *   executes in `node:vm` for React rendering. Security is equivalent to
- *   `node:vm` — the QuickJS phase validates import restrictions only.
- *   No native addons needed, but only supports ES2020 and is slower.
- *   For true isolation on servers, use `isolated-vm`.
- */
-type SandboxStrategy = "vm" | "isolated-vm" | "quickjs";
-interface CompileReactEmailOptions {
-    /**
-     * Sandbox strategy to use for executing user JSX code.
-     * @default "isolated-vm"
-     */
-    sandbox?: SandboxStrategy;
+interface ClientTruncation {
+    client: string;
+    subjectLimit: number;
+    preheaderLimit: number;
+    truncatedSubject: string | null;
+    truncatedPreheader: string | null;
+    subjectTruncated: boolean;
+    preheaderTruncated: boolean;
+}
+interface InboxPreview {
+    subject: string | null;
+    preheader: string | null;
+    subjectLength: number;
+    preheaderLength: number;
+    truncation: ClientTruncation[];
+    issues: InboxPreviewIssue[];
+}
+interface SizeIssue {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    detail?: string;
+}
+interface SizeReport {
+    htmlBytes: number;
+    humanSize: string;
+    clipped: boolean;
+    issues: SizeIssue[];
+}
+interface TemplateIssue {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    variable: string;
+    location: "text" | "attribute";
+}
+interface TemplateReport {
+    unresolvedCount: number;
+    issues: TemplateIssue[];
+}
+interface DeliverabilityCheck {
+    name: "spf" | "dkim" | "dmarc" | "mx" | "bimi";
+    status: "pass" | "fail" | "warn" | "skip";
+    message: string;
+    detail?: string;
+    record?: string;
+}
+interface DeliverabilityReport {
+    domain: string;
+    checks: DeliverabilityCheck[];
+    score: number;
+    issues: DeliverabilityIssue[];
+}
+interface DeliverabilityIssue {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    detail?: string;
 }
-/**
- * Compile a React Email JSX/TSX source string into an HTML email string.
- *
- * Pipeline:
- *  1. Validate input (size, basic checks)
- *  2. Transpile JSX/TSX → CommonJS JS using sucrase
- *  3. Execute inside a sandbox (configurable strategy)
- *  4. Render the exported component to a full HTML email string
- *
- * Requires peer dependencies: sucrase, react, @react-email/components,
- * @react-email/render. Additionally:
- *  - sandbox "isolated-vm" requires `isolated-vm`
- *  - sandbox "quickjs" requires `quickjs-emscripten`
- */
-declare function compileReactEmail(source: string, options?: CompileReactEmailOptions): Promise<string>;
 
-export { type AiProvider as A, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, type ImageReport as I, type LinkReport as L, type PreviewResult as P, type SpamAnalysisOptions as S, type TransformResult as T, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamReport as d, type AccessibilityReport as e, type AccessibilityIssue as f, CompileError as g, type CompileReactEmailOptions as h, type EstimateOptions as i, type ExportScope as j, type FixType as k, type ImageInfo as l, type ImageIssue as m, type InputFormat as n, type LinkIssue as o, type SandboxStrategy as p, type SpamIssue as q, type SupportLevel as r, type TokenEstimate as s, type TokenEstimateWithWarnings as t, estimateAiFixTokens as u, generateFixPrompt as v, heuristicTokenCount as w, compileReactEmail as x };
+export { type AiProvider as A, type TokenEstimateWithWarnings as B, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, estimateAiFixTokens as G, generateFixPrompt as H, type ImageReport as I, heuristicTokenCount as J, type LinkReport as L, type PreviewResult as P, type SupportLevel as S, type TransformResult as T, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamAnalysisOptions as d, type SpamReport as e, type AccessibilityReport as f, type InboxPreview as g, type SizeReport as h, type TemplateReport as i, type DeliverabilityReport as j, type AccessibilityIssue as k, type ClientTruncation as l, type DeliverabilityCheck as m, type DeliverabilityIssue as n, type EstimateOptions as o, type ExportScope as p, type FixType as q, type ImageInfo as r, type ImageIssue as s, type InboxPreviewIssue as t, type InputFormat as u, type LinkIssue as v, type SizeIssue as w, type SpamIssue as x, type TemplateIssue as y, type TokenEstimate as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailens/engine",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Email compatibility engine — transforms CSS per email client, scores compatibility, simulates dark mode, suggests fixes, and runs spam, accessibility, link, and image quality analysis.",
   "type": "module",
   "exports": {
@@ -13,6 +13,11 @@
       "types": "./dist/compile/index.d.ts",
       "import": "./dist/compile/index.js",
       "require": "./dist/compile/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
     }
   },
   "types": "./dist/index.d.ts",
@@ -28,6 +33,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
+    "sync:caniemail": "bun run scripts/sync-caniemail.ts",
     "test": "bun test",
     "prepublishOnly": "bun run build"
   },
@@ -36,14 +42,14 @@
     "css-tree": "^3.1.0"
   },
   "peerDependencies": {
-    "sucrase": "^3.35.0",
-    "react": "^18.0.0 || ^19.0.0",
+    "@maizzle/framework": ">=5.0.0",
     "@react-email/components": ">=0.0.36",
     "@react-email/render": ">=1.0.0",
-    "mjml": ">=4.0.0",
-    "@maizzle/framework": ">=5.0.0",
     "isolated-vm": ">=5.0.0",
-    "quickjs-emscripten": ">=0.29.0"
+    "mjml": ">=4.0.0",
+    "quickjs-emscripten": ">=0.29.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "sucrase": "^3.35.0"
   },
   "peerDependenciesMeta": {
     "sucrase": {
@@ -75,6 +81,7 @@
     "@maizzle/framework": "^5.0.0",
     "@react-email/components": "^0.0.36",
     "@react-email/render": "^1.0.6",
+    "@types/bun": "^1.3.9",
     "@types/css-tree": "^2.3.11",
     "@types/mjml": "^4.7.4",
     "@types/node": "^25.3.0",

package/dist/maizzle-Y2CLJ7GB.js

@@ -1,8 +0,0 @@
-import {
-  compileMaizzle
-} from "./chunk-OY3DGZVU.js";
-import "./chunk-ZQF2XUIJ.js";
-export {
-  compileMaizzle
-};
-//# sourceMappingURL=maizzle-Y2CLJ7GB.js.map

package/dist/mjml-D7IOYXXK.js

@@ -1,8 +0,0 @@
-import {
-  compileMjml
-} from "./chunk-3NDQOTPM.js";
-import "./chunk-ZQF2XUIJ.js";
-export {
-  compileMjml
-};
-//# sourceMappingURL=mjml-D7IOYXXK.js.map

package/dist/react-email-4TW6IDAA.js

@@ -1,8 +0,0 @@
-import {
-  compileReactEmail
-} from "./chunk-URZ4XPST.js";
-import "./chunk-ZQF2XUIJ.js";
-export {
-  compileReactEmail
-};
-//# sourceMappingURL=react-email-4TW6IDAA.js.map