@emailens/engine 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -71,11 +71,14 @@ __export(index_exports, {
   analyzeSpam: () => analyzeSpam,
   auditEmail: () => auditEmail,
   checkAccessibility: () => checkAccessibility,
+  checkSize: () => checkSize,
+  checkTemplateVariables: () => checkTemplateVariables,
   contrastRatio: () => contrastRatio,
   createSession: () => createSession,
   diffResults: () => diffResults,
   errorWarnings: () => errorWarnings,
   estimateAiFixTokens: () => estimateAiFixTokens,
+  extractInboxPreview: () => extractInboxPreview,
   generateAiFix: () => generateAiFix,
   generateCompatibilityScore: () => generateCompatibilityScore,
   generateFixPrompt: () => generateFixPrompt,
@@ -2837,6 +2840,32 @@ var GENERIC_LINK_TEXT = /* @__PURE__ */ new Set([
   "tap here",
   "this"
 ]);
+var GMAIL_CLIP_THRESHOLD = 102 * 1024;
+var GMAIL_CLIP_WARNING_THRESHOLD = 90 * 1024;
+var CLIENT_DISPLAY_LIMITS = [
+  { client: "Gmail (Web)", subjectLimit: 70, preheaderLimit: 90 },
+  { client: "Gmail (Mobile)", subjectLimit: 40, preheaderLimit: 90 },
+  { client: "Outlook (Web)", subjectLimit: 60, preheaderLimit: 35 },
+  { client: "Outlook (Desktop)", subjectLimit: 55, preheaderLimit: 35 },
+  { client: "Apple Mail (macOS)", subjectLimit: 78, preheaderLimit: 140 },
+  { client: "Apple Mail (iOS)", subjectLimit: 35, preheaderLimit: 90 },
+  { client: "Yahoo Mail", subjectLimit: 46, preheaderLimit: 100 },
+  { client: "Samsung Email", subjectLimit: 40, preheaderLimit: 70 }
+];
+var TEMPLATE_VARIABLE_PATTERNS = [
+  [/\{\{[\s\S]*?\}\}/g, "Handlebars/Mustache"],
+  // {{var}}
+  [/\$\{[^}]+\}/g, "ES template literal"],
+  // ${var}
+  [/<%=?\s*[^%]+%>/g, "ERB/EJS"],
+  // <% %> / <%= %>
+  [/\*\|[A-Z_][A-Z0-9_]*\|\*/g, "Mailchimp merge tag"],
+  // *|TAG|*
+  [/%%[A-Za-z_][A-Za-z0-9_]*%%/g, "Salesforce AMPscript"],
+  // %%tag%%
+  [/\{[A-Za-z_][A-Za-z0-9_.]{2,}\}/g, "Single-brace merge field"]
+  // {merge_field} (3+ char names)
+];
 var EMPTY_SPAM = { score: 100, level: "low", issues: [] };
 var EMPTY_LINKS = {
   totalLinks: 0,
@@ -2845,6 +2874,9 @@ var EMPTY_LINKS = {
 };
 var EMPTY_ACCESSIBILITY = { score: 100, issues: [] };
 var EMPTY_IMAGES = { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
+var EMPTY_INBOX_PREVIEW = { subject: null, preheader: null, subjectLength: 0, preheaderLength: 0, truncation: [], issues: [] };
+var EMPTY_SIZE = { htmlBytes: 0, humanSize: "0 B", clipped: false, issues: [] };
+var EMPTY_TEMPLATE = { unresolvedCount: 0, issues: [] };
 
 // src/transform.ts
 function inlineStyles($) {
@@ -4507,7 +4539,9 @@ var WEIGHTS = {
   "image-only": 20,
   "high-image-ratio": 10,
   "deceptive-link": 15,
-  "all-caps-subject": 10
+  "all-caps-subject": 10,
+  "missing-physical-address": 8,
+  "missing-one-click-unsubscribe": 5
 };
 function extractVisibleText($) {
   const clone = $.root().clone();
@@ -4724,6 +4758,47 @@ Href: ${href}`
   });
   return issues;
 }
+var STREET_ADDRESS_PATTERN = /\b\d{1,5}\s+[A-Za-z]+\s+(St(reet)?|Ave(nue)?|Blvd|Boulevard|Dr(ive)?|Rd|Road|Ln|Lane|Way|Ct|Court|Pl(ace)?|Pkwy|Parkway|Cir(cle)?|Terr(ace)?|Loop)\b/i;
+var PO_BOX_PATTERN = /\bP\.?\s*O\.?\s*Box\s+\d+/i;
+var ZIP_CODE_PATTERN = /\b\d{5}(-\d{4})?\b/;
+var ADDRESS_CLASS_PATTERN = /address|mailing|postal|footer-address|physical-address/i;
+function checkPhysicalAddress($, text, options) {
+  if ((options == null ? void 0 : options.emailType) === "transactional") return null;
+  if (STREET_ADDRESS_PATTERN.test(text) && ZIP_CODE_PATTERN.test(text)) return null;
+  if (PO_BOX_PATTERN.test(text) && ZIP_CODE_PATTERN.test(text)) return null;
+  let foundByClass = false;
+  $("[class]").each((_, el) => {
+    const cls = $(el).attr("class") || "";
+    if (ADDRESS_CLASS_PATTERN.test(cls)) {
+      const elText = $(el).text().trim();
+      if (elText.length > 5) {
+        foundByClass = true;
+        return false;
+      }
+    }
+  });
+  if (foundByClass) return null;
+  if ($("address").length > 0 && $("address").text().trim().length > 5) return null;
+  return {
+    rule: "missing-physical-address",
+    severity: "warning",
+    message: "No physical mailing address detected \u2014 required by CAN-SPAM for marketing emails.",
+    detail: "Include a street address or P.O. Box in the email footer."
+  };
+}
+function checkOneClickUnsubscribe(options) {
+  var _a, _b;
+  if (!((_a = options == null ? void 0 : options.listUnsubscribeHeader) == null ? void 0 : _a.trim())) return null;
+  if (!((_b = options == null ? void 0 : options.listUnsubscribePostHeader) == null ? void 0 : _b.trim())) {
+    return {
+      rule: "missing-one-click-unsubscribe",
+      severity: "warning",
+      message: "List-Unsubscribe header present but missing List-Unsubscribe-Post header (RFC 8058). Gmail and Yahoo require one-click unsubscribe.",
+      detail: 'Add "List-Unsubscribe-Post: List-Unsubscribe=One-Click" header.'
+    };
+  }
+  return null;
+}
 function checkAllCapsTitle($) {
   const title = $("title").text().trim();
   if (title.length > 5 && title === title.toUpperCase() && /[A-Z]/.test(title)) {
@@ -4753,6 +4828,10 @@ function analyzeSpamFromDom($, options) {
   issues.push(...checkDeceptiveLinks($));
   const capsTitle = checkAllCapsTitle($);
   if (capsTitle) issues.push(capsTitle);
+  const addressIssue = checkPhysicalAddress($, text, options);
+  if (addressIssue) issues.push(addressIssue);
+  const oneClickIssue = checkOneClickUnsubscribe(options);
+  if (oneClickIssue) issues.push(oneClickIssue);
   let penalty = 0;
   const seenRules = /* @__PURE__ */ new Map();
   for (const issue of issues) {
@@ -4941,6 +5020,23 @@ function validateLinksFromDom($) {
       });
     }
   });
+  links.each((_, el) => {
+    const href = $(el).attr("href") || "";
+    const trimmed = href.trim();
+    if (trimmed.startsWith("#") && trimmed.length > 1) {
+      const targetId = trimmed.slice(1);
+      const target = $(`[id="${targetId}"]`);
+      if (target.length === 0) {
+        issues.push({
+          severity: "error",
+          rule: "broken-anchor",
+          message: `Anchor link "${trimmed}" points to an element that does not exist`,
+          href: trimmed,
+          text: $(el).text().trim().slice(0, 80) || "(no text)"
+        });
+      }
+    }
+  });
   for (const [href, count] of hrefCounts) {
     if (count > 5) {
       issues.push({
@@ -5194,6 +5290,21 @@ function checkTextSizeAndContrast($) {
   }
   return issues;
 }
+function checkCharsetDeclaration($) {
+  const metaCharset = $("meta[charset]");
+  if (metaCharset.length > 0) return null;
+  const httpEquiv = $('meta[http-equiv="Content-Type"]');
+  if (httpEquiv.length > 0) {
+    const content = httpEquiv.attr("content") || "";
+    if (/charset\s*=/i.test(content)) return null;
+  }
+  return {
+    severity: "warning",
+    rule: "missing-charset",
+    message: "Missing charset declaration",
+    details: 'Add <meta charset="utf-8"> in <head> to prevent encoding issues across email clients.'
+  };
+}
 function checkSemanticStructure($) {
   const issues = [];
   const headings = [];
@@ -5226,6 +5337,8 @@ function checkAccessibilityFromDom($) {
   issues.push(...checkTableAccessibility($));
   issues.push(...checkTextSizeAndContrast($));
   issues.push(...checkSemanticStructure($));
+  const charsetIssue = checkCharsetDeclaration($);
+  if (charsetIssue) issues.push(charsetIssue);
   let penalty = 0;
   const seenRules = /* @__PURE__ */ new Map();
   for (const issue of issues) {
@@ -5428,8 +5541,307 @@ function analyzeImages(html) {
   return analyzeImagesFromDom($);
 }
 
-// src/audit.ts
+// src/inbox-preview.ts
 var cheerio8 = __toESM(require("cheerio"), 1);
+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*(&nbsp;|\u00A0)\s*){2,}|(&zwnj;\s*&nbsp;\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 $ = cheerio8.load(html);
+  return extractInboxPreviewFromDom($);
+}
+function extractInboxPreviewFromDom($) {
+  var _a, _b;
+  const issues = [];
+  const titleEl = $("title");
+  const subject = titleEl.length > 0 ? titleEl.first().text().trim() || null : null;
+  const subjectLength = (_a = subject == null ? void 0 : subject.length) != null ? _a : 0;
+  if (!subject) {
+    issues.push({
+      rule: "missing-subject",
+      severity: "warning",
+      message: "No <title> tag found. Most email clients use this as the subject line."
+    });
+  } else if (subjectLength > MAX_SUBJECT_LENGTH) {
+    issues.push({
+      rule: "subject-too-long",
+      severity: "warning",
+      message: `Subject is ${subjectLength} characters \u2014 may be truncated in inboxes (recommended: ${MAX_SUBJECT_LENGTH} or fewer).`
+    });
+  }
+  const preheader = extractPreheaderText($);
+  const preheaderLength = (_b = preheader == null ? void 0 : preheader.length) != null ? _b : 0;
+  if (!preheader) {
+    issues.push({
+      rule: "missing-preheader",
+      severity: "info",
+      message: "No preheader text detected. Adding preview text improves open rates in crowded inboxes."
+    });
+  } else if (preheaderLength < MIN_PREHEADER_LENGTH) {
+    issues.push({
+      rule: "preheader-too-short",
+      severity: "warning",
+      message: `Preheader is only ${preheaderLength} characters \u2014 email clients may backfill with body text (recommended: ${MIN_PREHEADER_LENGTH}+).`
+    });
+  } else if (preheaderLength > MAX_PREHEADER_LENGTH) {
+    issues.push({
+      rule: "preheader-too-long",
+      severity: "info",
+      message: `Preheader is ${preheaderLength} characters \u2014 most clients show 40\u2013100 characters. Text beyond that is hidden.`
+    });
+  }
+  if (hasZwnjPadding($)) {
+    issues.push({
+      rule: "zwnj-padding",
+      severity: "info",
+      message: "Preheader uses &zwnj;&nbsp; padding hack \u2014 works in most clients but may show garbled text in some."
+    });
+  }
+  if (subject && EMOJI_PATTERN.test(subject)) {
+    issues.push({
+      rule: "emoji-in-subject",
+      severity: "info",
+      message: "Subject line contains emoji \u2014 renders inconsistently across email clients and may trigger spam filters."
+    });
+  }
+  const truncation = computeTruncation(subject, preheader);
+  return {
+    subject,
+    preheader,
+    subjectLength,
+    preheaderLength,
+    truncation,
+    issues
+  };
+}
+function computeTruncation(subject, preheader) {
+  return CLIENT_DISPLAY_LIMITS.map((limit) => {
+    const truncatedSubject = subject && subject.length > limit.subjectLimit ? subject.slice(0, limit.subjectLimit - 1) + "\u2026" : subject;
+    const truncatedPreheader = preheader && preheader.length > limit.preheaderLimit ? preheader.slice(0, limit.preheaderLimit - 1) + "\u2026" : preheader;
+    return {
+      client: limit.client,
+      subjectLimit: limit.subjectLimit,
+      preheaderLimit: limit.preheaderLimit,
+      truncatedSubject: truncatedSubject != null ? truncatedSubject : null,
+      truncatedPreheader: truncatedPreheader != null ? truncatedPreheader : null,
+      subjectTruncated: !!subject && subject.length > limit.subjectLimit,
+      preheaderTruncated: !!preheader && preheader.length > limit.preheaderLimit
+    };
+  });
+}
+function hasZwnjPadding($) {
+  const body = $("body");
+  if (!body.length) return false;
+  const hiddenSelectors = [
+    'div[style*="display:none"]',
+    'div[style*="display: none"]',
+    'span[style*="display:none"]',
+    'span[style*="display: none"]',
+    'div[style*="max-height:0"]',
+    'div[style*="max-height: 0"]',
+    'span[style*="max-height:0"]',
+    'span[style*="max-height: 0"]',
+    '[class*="preheader"]',
+    '[class*="preview-text"]',
+    '[class*="previewText"]'
+  ];
+  for (const sel of hiddenSelectors) {
+    const el = body.find(sel).first();
+    if (el.length) {
+      const rawHtml = el.html() || "";
+      if (ZWNJ_PADDING_PATTERN.test(rawHtml)) return true;
+    }
+  }
+  return false;
+}
+function extractPreheaderText($) {
+  const body = $("body");
+  if (!body.length) return null;
+  const hiddenSelectors = [
+    'div[style*="display:none"]',
+    'div[style*="display: none"]',
+    'span[style*="display:none"]',
+    'span[style*="display: none"]',
+    'div[style*="visibility:hidden"]',
+    'div[style*="visibility: hidden"]',
+    'span[style*="visibility:hidden"]',
+    'span[style*="visibility: hidden"]',
+    'div[style*="max-height:0"]',
+    'div[style*="max-height: 0"]',
+    'span[style*="max-height:0"]',
+    'span[style*="max-height: 0"]',
+    'div[style*="mso-hide:all"]',
+    'div[style*="mso-hide: all"]'
+  ];
+  for (const sel of hiddenSelectors) {
+    const el = body.find(sel).first();
+    if (el.length) {
+      const text = el.text().trim();
+      if (text) return text;
+    }
+  }
+  const preheaderClasses = body.find(
+    '[class*="preheader"], [class*="preview-text"], [class*="previewText"]'
+  ).first();
+  if (preheaderClasses.length) {
+    const text = preheaderClasses.text().trim();
+    if (text) return text;
+  }
+  const firstText = getFirstVisibleText($, body);
+  return firstText || null;
+}
+function getFirstVisibleText($, body) {
+  const skipTags = /* @__PURE__ */ new Set(["style", "script", "head", "title"]);
+  let result = null;
+  body.find("*").each((_, el) => {
+    var _a;
+    if (result) return false;
+    const tagName = (_a = el.tagName) == null ? void 0 : _a.toLowerCase();
+    if (skipTags.has(tagName)) return;
+    const style = $(el).attr("style") || "";
+    if (style.includes("display:none") || style.includes("display: none") || style.includes("visibility:hidden") || style.includes("visibility: hidden")) {
+      return;
+    }
+    const directText = $(el).contents().filter((_2, node) => node.type === "text").text().trim();
+    if (directText && directText.length > 1) {
+      const cleaned = directText.replace(/[\u200B\u00A0\s]+/g, " ").trim();
+      if (cleaned.length > 1) {
+        result = cleaned;
+        return false;
+      }
+    }
+  });
+  return result;
+}
+
+// src/size-checker.ts
+var cheerio9 = __toESM(require("cheerio"), 1);
+function humanizeBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  const kb = bytes / 1024;
+  if (kb < 1024) return `${kb.toFixed(1)} KB`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(2)} MB`;
+}
+function checkSizeFromDom(_$, html) {
+  const htmlBytes = new TextEncoder().encode(html).length;
+  const humanSize = humanizeBytes(htmlBytes);
+  const issues = [];
+  let clipped = false;
+  if (htmlBytes > GMAIL_CLIP_THRESHOLD) {
+    clipped = true;
+    issues.push({
+      rule: "gmail-clipped",
+      severity: "error",
+      message: `Email is ${humanSize} \u2014 Gmail will clip it at ~102 KB. Recipients see a "View entire message" link instead of your content.`,
+      detail: `${htmlBytes} bytes exceeds the ${GMAIL_CLIP_THRESHOLD} byte threshold.`
+    });
+  } else if (htmlBytes > GMAIL_CLIP_WARNING_THRESHOLD) {
+    issues.push({
+      rule: "gmail-clip-warning",
+      severity: "warning",
+      message: `Email is ${humanSize} \u2014 approaching Gmail's ~102 KB clip threshold. Consider trimming.`,
+      detail: `${htmlBytes} bytes is within ${GMAIL_CLIP_THRESHOLD - htmlBytes} bytes of the clip threshold.`
+    });
+  }
+  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 $ = cheerio9.load(html);
+  return checkSizeFromDom($, html);
+}
+
+// src/template-checker.ts
+var cheerio10 = __toESM(require("cheerio"), 1);
+function checkTemplateVariablesFromDom($) {
+  const issues = [];
+  const seen = /* @__PURE__ */ new Set();
+  const textContent = extractTextContent($);
+  for (const [pattern, label] of TEMPLATE_VARIABLE_PATTERNS) {
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(textContent)) !== null) {
+      const variable = match[0];
+      const key = `text:${variable}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      issues.push({
+        rule: "unresolved-variable",
+        severity: "error",
+        message: `Unresolved ${label} variable "${variable}" found in text content.`,
+        variable,
+        location: "text"
+      });
+    }
+  }
+  const attrSelectors = ["[href]", "[src]", "[alt]"];
+  for (const sel of attrSelectors) {
+    $(sel).each((_, el) => {
+      const attrs = ["href", "src", "alt"];
+      for (const attr of attrs) {
+        const value = $(el).attr(attr);
+        if (!value) continue;
+        for (const [pattern, label] of TEMPLATE_VARIABLE_PATTERNS) {
+          pattern.lastIndex = 0;
+          let match;
+          while ((match = pattern.exec(value)) !== null) {
+            const variable = match[0];
+            const key = `attr:${attr}:${variable}`;
+            if (seen.has(key)) continue;
+            seen.add(key);
+            issues.push({
+              rule: "unresolved-variable",
+              severity: "error",
+              message: `Unresolved ${label} variable "${variable}" found in ${attr} attribute.`,
+              variable,
+              location: "attribute"
+            });
+          }
+        }
+      }
+    });
+  }
+  return { unresolvedCount: issues.length, issues };
+}
+function extractTextContent($) {
+  const clone = $.root().clone();
+  clone.find("style, script, head").remove();
+  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 $ = cheerio10.load(html);
+  return checkTemplateVariablesFromDom($);
+}
+
+// src/audit.ts
+var cheerio11 = __toESM(require("cheerio"), 1);
 function auditEmail(html, options) {
   var _a;
   if (!html || !html.trim()) {
@@ -5438,7 +5850,10 @@ function auditEmail(html, options) {
       spam: EMPTY_SPAM,
       links: EMPTY_LINKS,
       accessibility: EMPTY_ACCESSIBILITY,
-      images: EMPTY_IMAGES
+      images: EMPTY_IMAGES,
+      inboxPreview: EMPTY_INBOX_PREVIEW,
+      size: EMPTY_SIZE,
+      templateVariables: EMPTY_TEMPLATE
     };
   }
   if (html.length > MAX_HTML_SIZE) {
@@ -5446,18 +5861,21 @@ 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 $ = cheerio8.load(html);
+  const $ = cheerio11.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);
   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 };
+  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 };
 }
 
 // src/session.ts
-var cheerio9 = __toESM(require("cheerio"), 1);
+var cheerio12 = __toESM(require("cheerio"), 1);
 function createSession(html, options) {
   if (!html || !html.trim()) {
     const fw = options == null ? void 0 : options.framework;
@@ -5469,7 +5887,10 @@ function createSession(html, options) {
         spam: EMPTY_SPAM,
         links: EMPTY_LINKS,
         accessibility: EMPTY_ACCESSIBILITY,
-        images: EMPTY_IMAGES
+        images: EMPTY_IMAGES,
+        inboxPreview: EMPTY_INBOX_PREVIEW,
+        size: EMPTY_SIZE,
+        templateVariables: EMPTY_TEMPLATE
       }),
       analyze: () => [],
       score: () => ({}),
@@ -5477,6 +5898,9 @@ function createSession(html, options) {
       validateLinks: () => EMPTY_LINKS,
       checkAccessibility: () => EMPTY_ACCESSIBILITY,
       analyzeImages: () => EMPTY_IMAGES,
+      extractInboxPreview: () => EMPTY_INBOX_PREVIEW,
+      checkSize: () => EMPTY_SIZE,
+      checkTemplateVariables: () => EMPTY_TEMPLATE,
       transformForClient: (clientId) => ({ clientId, html: html || "", warnings: [] }),
       transformForAllClients: () => [],
       simulateDarkMode: (clientId) => ({ html: html || "", warnings: [] })
@@ -5485,7 +5909,7 @@ function createSession(html, options) {
   if (html.length > MAX_HTML_SIZE) {
     throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
   }
-  const $ = cheerio9.load(html);
+  const $ = cheerio12.load(html);
   const framework = options == null ? void 0 : options.framework;
   return {
     html,
@@ -5499,7 +5923,10 @@ function createSession(html, options) {
       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 };
+      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 };
     },
     analyze() {
       return analyzeEmailFromDom($, framework);
@@ -5519,6 +5946,15 @@ function createSession(html, options) {
     analyzeImages() {
       return analyzeImagesFromDom($);
     },
+    extractInboxPreview() {
+      return extractInboxPreviewFromDom($);
+    },
+    checkSize() {
+      return checkSizeFromDom($, html);
+    },
+    checkTemplateVariables() {
+      return checkTemplateVariablesFromDom($);
+    },
     // Transforms create isolated copies since they mutate the DOM
     transformForClient(clientId) {
       return transformForClient(html, clientId, framework);
@@ -5555,11 +5991,14 @@ var CompileError = class extends Error {
   analyzeSpam,
   auditEmail,
   checkAccessibility,
+  checkSize,
+  checkTemplateVariables,
   contrastRatio,
   createSession,
   diffResults,
   errorWarnings,
   estimateAiFixTokens,
+  extractInboxPreview,
   generateAiFix,
   generateCompatibilityScore,
   generateFixPrompt,