@emailens/engine 0.5.2 → 0.6.0

package/dist/index.cjs

@@ -72,6 +72,7 @@ __export(index_exports, {
   auditEmail: () => auditEmail,
   checkAccessibility: () => checkAccessibility,
   contrastRatio: () => contrastRatio,
+  createSession: () => createSession,
   diffResults: () => diffResults,
   errorWarnings: () => errorWarnings,
   estimateAiFixTokens: () => estimateAiFixTokens,
@@ -2836,6 +2837,14 @@ var GENERIC_LINK_TEXT = /* @__PURE__ */ new Set([
   "tap here",
   "this"
 ]);
+var EMPTY_SPAM = { score: 100, level: "low", issues: [] };
+var EMPTY_LINKS = {
+  totalLinks: 0,
+  issues: [],
+  breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
+};
+var EMPTY_ACCESSIBILITY = { score: 100, issues: [] };
+var EMPTY_IMAGES = { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
 
 // src/transform.ts
 function inlineStyles($) {
@@ -3344,15 +3353,8 @@ function transformForAllClients(html, framework) {
 // src/analyze.ts
 var cheerio2 = __toESM(require("cheerio"), 1);
 var csstree2 = __toESM(require("css-tree"), 1);
-function analyzeEmail(html, framework) {
+function analyzeEmailFromDom($, framework) {
   var _a, _b, _c, _d, _e, _f, _g;
-  if (!html || !html.trim()) {
-    return [];
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio2.load(html);
   const warnings = [];
   const seenWarnings = /* @__PURE__ */ new Set();
   function addWarning(w) {
@@ -3597,6 +3599,16 @@ function analyzeEmail(html, framework) {
   warnings.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
   return warnings;
 }
+function analyzeEmail(html, framework) {
+  if (!html || !html.trim()) {
+    return [];
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio2.load(html);
+  return analyzeEmailFromDom($, framework);
+}
 function getFixType(prop) {
   return STRUCTURAL_FIX_PROPERTIES.has(prop) ? "structural" : "css";
 }
@@ -4723,14 +4735,7 @@ function checkAllCapsTitle($) {
   }
   return null;
 }
-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 $ = cheerio4.load(html);
+function analyzeSpamFromDom($, options) {
   const text = extractVisibleText($);
   const issues = [];
   const capsIssue = checkCapsRatio(text);
@@ -4768,6 +4773,16 @@ function analyzeSpam(html, options) {
   const level = score >= 70 ? "low" : score >= 40 ? "medium" : "high";
   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 $ = cheerio4.load(html);
+  return analyzeSpamFromDom($, options);
+}
 
 // src/link-validator.ts
 var cheerio5 = __toESM(require("cheerio"), 1);
@@ -4787,18 +4802,7 @@ function isPlaceholderHref(href) {
   const h = href.trim().toLowerCase();
   return h === "#" || h === "" || h === "javascript:void(0)" || h === "javascript:;";
 }
-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 $ = cheerio5.load(html);
+function validateLinksFromDom($) {
   const issues = [];
   const breakdown = { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 };
   const links = $("a");
@@ -4949,6 +4953,20 @@ function validateLinks(html) {
   }
   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 $ = cheerio5.load(html);
+  return validateLinksFromDom($);
+}
 
 // src/accessibility-checker.ts
 var cheerio6 = __toESM(require("cheerio"), 1);
@@ -5197,14 +5215,7 @@ function checkSemanticStructure($) {
   }
   return 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 $ = cheerio6.load(html);
+function checkAccessibilityFromDom($) {
   const issues = [];
   const langIssue = checkLangAttribute($);
   if (langIssue) issues.push(langIssue);
@@ -5237,6 +5248,16 @@ function checkAccessibility(html) {
   const score = Math.max(0, 100 - penalty);
   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 $ = cheerio6.load(html);
+  return checkAccessibilityFromDom($);
+}
 
 // src/image-analyzer.ts
 var cheerio7 = __toESM(require("cheerio"), 1);
@@ -5270,14 +5291,7 @@ function truncateSrc(src, max = 60) {
   }
   return src.length > max ? src.slice(0, max - 3) + "..." : src;
 }
-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 $ = cheerio7.load(html);
+function analyzeImagesFromDom($) {
   const issues = [];
   const images = [];
   let totalDataUriBytes = 0;
@@ -5403,16 +5417,19 @@ function analyzeImages(html) {
   }
   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 $ = cheerio7.load(html);
+  return analyzeImagesFromDom($);
+}
 
 // src/audit.ts
-var EMPTY_SPAM = { score: 100, level: "low", issues: [] };
-var EMPTY_LINKS = {
-  totalLinks: 0,
-  issues: [],
-  breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
-};
-var EMPTY_ACCESSIBILITY = { score: 100, issues: [] };
-var EMPTY_IMAGES = { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
+var cheerio8 = __toESM(require("cheerio"), 1);
 function auditEmail(html, options) {
   var _a;
   if (!html || !html.trim()) {
@@ -5429,15 +5446,92 @@ function auditEmail(html, options) {
   }
   const framework = options == null ? void 0 : options.framework;
   const skip = new Set((_a = options == null ? void 0 : options.skip) != null ? _a : []);
-  const warnings = skip.has("compatibility") ? [] : analyzeEmail(html, framework);
+  const $ = cheerio8.load(html);
+  const warnings = skip.has("compatibility") ? [] : analyzeEmailFromDom($, framework);
   const scores = skip.has("compatibility") ? {} : generateCompatibilityScore(warnings);
-  const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpam(html, options == null ? void 0 : options.spam);
-  const links = skip.has("links") ? EMPTY_LINKS : validateLinks(html);
-  const accessibility = skip.has("accessibility") ? EMPTY_ACCESSIBILITY : checkAccessibility(html);
-  const images = skip.has("images") ? EMPTY_IMAGES : analyzeImages(html);
+  const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpamFromDom($, options == null ? void 0 : options.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($);
   return { compatibility: { warnings, scores }, spam, links, accessibility, images };
 }
 
+// src/session.ts
+var cheerio9 = __toESM(require("cheerio"), 1);
+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
+      }),
+      analyze: () => [],
+      score: () => ({}),
+      analyzeSpam: () => EMPTY_SPAM,
+      validateLinks: () => EMPTY_LINKS,
+      checkAccessibility: () => EMPTY_ACCESSIBILITY,
+      analyzeImages: () => EMPTY_IMAGES,
+      transformForClient: (clientId) => ({ clientId, html: html || "", warnings: [] }),
+      transformForAllClients: () => [],
+      simulateDarkMode: (clientId) => ({ html: html || "", warnings: [] })
+    };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio9.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($);
+      return { compatibility: { warnings, scores }, spam, links, accessibility, images };
+    },
+    analyze() {
+      return analyzeEmailFromDom($, framework);
+    },
+    score(warnings) {
+      return generateCompatibilityScore(warnings);
+    },
+    analyzeSpam(opts) {
+      return analyzeSpamFromDom($, opts);
+    },
+    validateLinks() {
+      return validateLinksFromDom($);
+    },
+    checkAccessibility() {
+      return checkAccessibilityFromDom($);
+    },
+    analyzeImages() {
+      return analyzeImagesFromDom($);
+    },
+    // Transforms create isolated copies since they mutate the DOM
+    transformForClient(clientId) {
+      return transformForClient(html, clientId, framework);
+    },
+    transformForAllClients() {
+      return transformForAllClients(html, framework);
+    },
+    simulateDarkMode(clientId) {
+      return simulateDarkMode(html, clientId);
+    }
+  };
+}
+
 // src/compile/errors.ts
 var CompileError = class extends Error {
   constructor(message, format, phase) {
@@ -5462,6 +5556,7 @@ var CompileError = class extends Error {
   auditEmail,
   checkAccessibility,
   contrastRatio,
+  createSession,
   diffResults,
   errorWarnings,
   estimateAiFixTokens,