@emailens/engine 0.9.4 → 0.9.6

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-Duj14jTL.cjs';
-export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-Duj14jTL.cjs';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-BFwlVmzZ.cjs';
+import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-WvVf2OXX.cjs';
+export { k as AccessibilityIssue, B as BaseIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as Severity, x as SizeIssue, y as SpamIssue, z as TemplateIssue, G as TokenEstimate, H as TokenEstimateWithWarnings, J as estimateAiFixTokens, K as generateFixPrompt, M as heuristicTokenCount } from './types-WvVf2OXX.cjs';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-M23kFFxl.cjs';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-Duj14jTL.js';
-export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-Duj14jTL.js';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-BENS7LIn.js';
+import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-WvVf2OXX.js';
+export { k as AccessibilityIssue, B as BaseIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as Severity, x as SizeIssue, y as SpamIssue, z as TemplateIssue, G as TokenEstimate, H as TokenEstimateWithWarnings, J as estimateAiFixTokens, K as generateFixPrompt, M as heuristicTokenCount } from './types-WvVf2OXX.js';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-TJF6usIm.js';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;

package/dist/index.js

@@ -8306,7 +8306,8 @@ function generateFixPrompt(options) {
     scores,
     scope,
     selectedClientId,
-    format = "html"
+    format = "html",
+    intent
   } = options;
   const filteredWarnings = scope === "current" && selectedClientId ? warnings.filter((w) => w.client === selectedClientId) : warnings;
   const filteredScores = scope === "current" && selectedClientId ? { [selectedClientId]: scores[selectedClientId] } : scores;
@@ -8329,6 +8330,16 @@ function generateFixPrompt(options) {
 - **Scope:** ${clientLabel}
 - **Issues found:** ${errorCount} error${errorCount !== 1 ? "s" : ""}, ${warnCount} warning${warnCount !== 1 ? "s" : ""}, ${infoCount} info`
   );
+  const trimmedIntent = intent == null ? void 0 : intent.trim();
+  if (trimmedIntent) {
+    sections.push(
+      `## User Intent
+
+The user described what they want this email to achieve. Honor it where possible, but never at the cost of breaking email-client compatibility:
+
+` + trimmedIntent
+    );
+  }
   sections.push(
     `## Original Email Code
 
@@ -8564,8 +8575,17 @@ function extractCode(response) {
   return response.trim();
 }
 
-// src/spam-scorer.ts
+// src/parse-html.ts
 import * as cheerio5 from "cheerio";
+function fromHtml(html, empty, fn) {
+  if (!html || !html.trim()) return empty;
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  return fn(cheerio5.load(html), html);
+}
+
+// src/spam-scorer.ts
 var SPAM_TRIGGER_PHRASES = [
   "act now",
   "limited time",
@@ -8995,18 +9015,10 @@ function analyzeSpamFromDom($, options) {
   return { score, level, issues };
 }
 function analyzeSpam(html, options) {
-  if (!html || !html.trim()) {
-    return { score: 100, level: "low", issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio5.load(html);
-  return analyzeSpamFromDom($, options);
+  return fromHtml(html, EMPTY_SPAM, ($) => analyzeSpamFromDom($, options));
 }
 
 // src/link-validator.ts
-import * as cheerio6 from "cheerio";
 function classifyHref(href) {
   if (!href || !href.trim()) return "empty";
   const h = href.trim().toLowerCase();
@@ -9192,22 +9204,10 @@ function validateLinksFromDom($) {
   return { totalLinks, issues, breakdown };
 }
 function validateLinks(html) {
-  if (!html || !html.trim()) {
-    return {
-      totalLinks: 0,
-      issues: [],
-      breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
-    };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio6.load(html);
-  return validateLinksFromDom($);
+  return fromHtml(html, EMPTY_LINKS, validateLinksFromDom);
 }
 
 // src/accessibility-checker.ts
-import * as cheerio7 from "cheerio";
 var RULE_PENALTY_CAPS = {
   "img-missing-alt": 3,
   "link-generic-text": 3,
@@ -9504,18 +9504,10 @@ function checkAccessibilityFromDom($) {
   return { score, issues };
 }
 function checkAccessibility(html) {
-  if (!html || !html.trim()) {
-    return { score: 100, issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio7.load(html);
-  return checkAccessibilityFromDom($);
+  return fromHtml(html, EMPTY_ACCESSIBILITY, checkAccessibilityFromDom);
 }
 
 // src/image-analyzer.ts
-import * as cheerio8 from "cheerio";
 var DATA_URI_WARN_BYTES = 100 * 1024;
 var TOTAL_DATA_URI_WARN_BYTES = 500 * 1024;
 var HIGH_IMAGE_COUNT = 10;
@@ -9673,39 +9665,24 @@ function analyzeImagesFromDom($) {
   return { total: images.length, totalDataUriBytes, issues, images };
 }
 function analyzeImages(html) {
-  if (!html || !html.trim()) {
-    return { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio8.load(html);
-  return analyzeImagesFromDom($);
+  return fromHtml(html, EMPTY_IMAGES, analyzeImagesFromDom);
 }
 
 // src/inbox-preview.ts
-import * as cheerio9 from "cheerio";
 var MAX_SUBJECT_LENGTH = 60;
 var MAX_PREHEADER_LENGTH = 100;
 var MIN_PREHEADER_LENGTH = 30;
 var EMOJI_PATTERN = /[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}\u{2B50}-\u{2B55}\u{FE00}-\u{FE0F}\u{1F900}-\u{1F9FF}\u{1FA00}-\u{1FA6F}\u{1FA70}-\u{1FAFF}\u{200D}\u{20E3}\u{E0020}-\u{E007F}]/u;
 var ZWNJ_PADDING_PATTERN = /(\u200C\s*( |\u00A0)\s*){2,}|(‌\s* \s*){2,}/;
 function extractInboxPreview(html) {
-  if (!html || !html.trim()) {
-    return {
-      subject: null,
-      preheader: null,
-      subjectLength: 0,
-      preheaderLength: 0,
-      truncation: [],
-      issues: [{ rule: "missing-subject", severity: "warning", message: "No <title> tag found. Most email clients use this as the subject line." }]
-    };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio9.load(html);
-  return extractInboxPreviewFromDom($);
+  return fromHtml(html, {
+    subject: null,
+    preheader: null,
+    subjectLength: 0,
+    preheaderLength: 0,
+    truncation: [],
+    issues: [{ rule: "missing-subject", severity: "warning", message: "No <title> tag found. Most email clients use this as the subject line." }]
+  }, extractInboxPreviewFromDom);
 }
 function extractInboxPreviewFromDom($) {
   var _a, _b;
@@ -9872,7 +9849,6 @@ function getFirstVisibleText($, body) {
 }
 
 // src/size-checker.ts
-import * as cheerio10 from "cheerio";
 function humanizeBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   const kb = bytes / 1024;
@@ -9904,18 +9880,10 @@ function checkSizeFromDom(_$, html) {
   return { htmlBytes, humanSize, clipped, issues };
 }
 function checkSize(html) {
-  if (!html || !html.trim()) {
-    return { htmlBytes: 0, humanSize: "0 B", clipped: false, issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio10.load(html);
-  return checkSizeFromDom($, html);
+  return fromHtml(html, EMPTY_SIZE, checkSizeFromDom);
 }
 
 // src/template-checker.ts
-import * as cheerio11 from "cheerio";
 function checkTemplateVariablesFromDom($) {
   const issues = [];
   const seen = /* @__PURE__ */ new Set();
@@ -9972,38 +9940,23 @@ function extractTextContent($) {
   return clone.text();
 }
 function checkTemplateVariables(html) {
-  if (!html || !html.trim()) {
-    return { unresolvedCount: 0, issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio11.load(html);
-  return checkTemplateVariablesFromDom($);
+  return fromHtml(html, EMPTY_TEMPLATE, checkTemplateVariablesFromDom);
 }
 
 // src/audit.ts
-import * as cheerio12 from "cheerio";
-function auditEmail(html, options) {
+var EMPTY_AUDIT = {
+  compatibility: { warnings: [], scores: {} },
+  spam: EMPTY_SPAM,
+  links: EMPTY_LINKS,
+  accessibility: EMPTY_ACCESSIBILITY,
+  images: EMPTY_IMAGES,
+  inboxPreview: EMPTY_INBOX_PREVIEW,
+  size: EMPTY_SIZE,
+  templateVariables: EMPTY_TEMPLATE
+};
+function runAudit($, html, framework, options) {
   var _a;
-  if (!html || !html.trim()) {
-    return {
-      compatibility: { warnings: [], scores: {} },
-      spam: EMPTY_SPAM,
-      links: EMPTY_LINKS,
-      accessibility: EMPTY_ACCESSIBILITY,
-      images: EMPTY_IMAGES,
-      inboxPreview: EMPTY_INBOX_PREVIEW,
-      size: EMPTY_SIZE,
-      templateVariables: EMPTY_TEMPLATE
-    };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const framework = options == null ? void 0 : options.framework;
   const skip = new Set((_a = options == null ? void 0 : options.skip) != null ? _a : []);
-  const $ = cheerio12.load(html);
   const warnings = skip.has("compatibility") ? [] : analyzeEmailFromDom($, framework);
   const scores = skip.has("compatibility") ? {} : generateCompatibilityScore(warnings);
   const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpamFromDom($, options == null ? void 0 : options.spam);
@@ -10015,11 +9968,14 @@ function auditEmail(html, options) {
   const templateVariables = skip.has("templateVariables") ? EMPTY_TEMPLATE : checkTemplateVariablesFromDom($);
   return { compatibility: { warnings, scores }, spam, links, accessibility, images, inboxPreview, size, templateVariables };
 }
+function auditEmail(html, options) {
+  return fromHtml(html, EMPTY_AUDIT, ($, h) => runAudit($, h, options == null ? void 0 : options.framework, options));
+}
 
 // src/plain-text.ts
-import * as cheerio13 from "cheerio";
+import * as cheerio6 from "cheerio";
 function toPlainText(html) {
-  const $ = cheerio13.load(html);
+  const $ = cheerio6.load(html);
   $("style, script, head").remove();
   $("[data-skip-in-text='true']").remove();
   const lines = [];
@@ -10121,23 +10077,14 @@ function toPlainText(html) {
 }
 
 // src/session.ts
-import * as cheerio14 from "cheerio";
+import * as cheerio7 from "cheerio";
 function createSession(html, options) {
   if (!html || !html.trim()) {
     const fw = options == null ? void 0 : options.framework;
     return {
       html: html || "",
       framework: fw,
-      audit: () => ({
-        compatibility: { warnings: [], scores: {} },
-        spam: EMPTY_SPAM,
-        links: EMPTY_LINKS,
-        accessibility: EMPTY_ACCESSIBILITY,
-        images: EMPTY_IMAGES,
-        inboxPreview: EMPTY_INBOX_PREVIEW,
-        size: EMPTY_SIZE,
-        templateVariables: EMPTY_TEMPLATE
-      }),
+      audit: () => EMPTY_AUDIT,
       analyze: () => [],
       score: () => ({}),
       analyzeSpam: () => EMPTY_SPAM,
@@ -10155,24 +10102,13 @@ function createSession(html, options) {
   if (html.length > MAX_HTML_SIZE) {
     throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
   }
-  const $ = cheerio14.load(html);
+  const $ = cheerio7.load(html);
   const framework = options == null ? void 0 : options.framework;
   return {
     html,
     framework,
     audit(opts) {
-      var _a;
-      const skip = new Set((_a = opts == null ? void 0 : opts.skip) != null ? _a : []);
-      const warnings = skip.has("compatibility") ? [] : analyzeEmailFromDom($, framework);
-      const scores = skip.has("compatibility") ? {} : generateCompatibilityScore(warnings);
-      const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpamFromDom($, opts == null ? void 0 : opts.spam);
-      const links = skip.has("links") ? EMPTY_LINKS : validateLinksFromDom($);
-      const accessibility = skip.has("accessibility") ? EMPTY_ACCESSIBILITY : checkAccessibilityFromDom($);
-      const images = skip.has("images") ? EMPTY_IMAGES : analyzeImagesFromDom($);
-      const inboxPreview = skip.has("inboxPreview") ? EMPTY_INBOX_PREVIEW : extractInboxPreviewFromDom($);
-      const size = skip.has("size") ? EMPTY_SIZE : checkSizeFromDom($, html);
-      const templateVariables = skip.has("templateVariables") ? EMPTY_TEMPLATE : checkTemplateVariablesFromDom($);
-      return { compatibility: { warnings, scores }, spam, links, accessibility, images, inboxPreview, size, templateVariables };
+      return runAudit($, html, framework, opts);
     },
     analyze() {
       return analyzeEmailFromDom($, framework);