@empline/preflight 1.1.11 → 1.1.13

package/dist/checks/email/email-template-validation.js

@@ -0,0 +1,688 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Email Template Validation Preflight (BLOCKING)
+ *
+ * Enforces local email template standards:
+ * 1. All templates must be defined in lib/seed-data/email-templates-v2.ts
+ * 2. Required templates must exist (ACCOUNT_VERIFICATION, PASSWORD_RESET, etc.)
+ * 3. Template naming must follow conventions (SCREAMING_SNAKE_CASE)
+ * 4. No direct DB queries for templates in sendgrid-service.ts (except legacy)
+ * 5. All templates must have required fields (subject, htmlContent, textContent)
+ *
+ * Usage:
+ *   pnpm preflight:email-templates              - BLOCKING mode
+ *   pnpm preflight:email-templates --warn       - Warning mode
+ *   pnpm preflight:email-templates --verbose    - Show all templates checked
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const findings_writer_1 = require("../../utils/findings-writer");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "email/email-template-validation";
+exports.name = "Email Template Validation";
+exports.category = "email";
+exports.blocking = true;
+exports.description = "Email Template Validation Preflight (BLOCKING)";
+exports.tags = ["email", "validation"];
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// CONFIGURATION
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+const CONFIG = {
+    // Source of truth for email templates
+    templateSourceFile: "lib/seed-data/email-templates-v2.ts",
+    // Local template registry
+    templateRegistryFile: "lib/email-templates/index.ts",
+    // SendGrid service file
+    sendgridServiceFile: "lib/sendgrid-service.ts",
+    // Required templates that MUST exist
+    requiredTemplates: [
+        "ACCOUNT_VERIFICATION",
+        "PASSWORD_RESET",
+        "ORDER_CONFIRMED",
+        "ORDER_RECEIVED",
+    ],
+    // All known template types (for validation)
+    knownTemplateTypes: [
+        "ACCOUNT_VERIFICATION",
+        "PASSWORD_RESET",
+        "SELLER_ONBOARDING",
+        "SELLER_APPROVAL",
+        "ORDER_CONFIRMED",
+        "ORDER_RECEIVED",
+        "ORDER_SHIPPED",
+        "ORDER_DELIVERED",
+        "ORDER_CANCELLED",
+        "ORDER_REFUNDED",
+        "LISTING_REJECTED",
+        "SELLER_NOTIFICATIONS",
+        "REVIEW_INVITE",
+        "PRICE_ALERT",
+        "SAVED_SEARCH_ALERT",
+        "BATCH_RECOGNITION_COMPLETE",
+        "PAYMENT_RECEIVED",
+        "PAYOUT_PROCESSED",
+        "NEW_REVIEW",
+        "LOW_STOCK_ALERT",
+        "WISHLIST_AVAILABLE",
+        "ABANDONED_CART",
+        "DISPUTE_OPENED",
+        "DISPUTE_RESPONSE_NEEDED",
+        "DISPUTE_RESOLVED",
+        "FOLLOWED_SELLER_NEW_LISTINGS",
+        "FOLLOWED_SELLER_PRICE_DROP",
+        "RETURN_APPROVED",
+        "RECOGNITION_ISSUE_REPORTED",
+        "AMAZON_FEED_ERROR",
+        "EBAY_FEED_ERROR",
+        "TCGPLAYER_FEED_ERROR",
+        "TEAM_INVITATION",
+    ],
+    // Template naming pattern (SCREAMING_SNAKE_CASE)
+    templateNamePattern: /^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$/,
+    // Required fields for each template
+    requiredFields: ["templateType", "version", "subject", "htmlContent", "textContent", "isActive"],
+    // Email footer must include notification settings link
+    footerNotificationSettingsLink: "/account/notifications",
+    // Email components file
+    emailComponentsFile: "lib/email-template-components.ts",
+    // Required styling patterns for consistency
+    styling: {
+        // Primary brand color (indigo)
+        primaryColor: "#4F46E5",
+        primaryColorAlt: "#4f46e5", // lowercase variant
+        // Forbidden old colors (blue scheme)
+        forbiddenColors: ["#1976d2", "#1565c0", "#2196f3"],
+        // Required dark mode patterns
+        darkModeMetaTags: ['color-scheme" content="light dark', "supported-color-schemes"],
+        // Required dark mode CSS
+        darkModeCssPattern: "@media (prefers-color-scheme: dark)",
+        // Required mobile responsive CSS
+        mobileResponsivePattern: "@media only screen and (max-width: 600px)",
+        // Required structural elements
+        requiredClasses: ["email-wrapper", "email-container", "header", "content", "footer"],
+    },
+};
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// VALIDATOR
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+class EmailTemplateValidator {
+    errors = [];
+    warnings = [];
+    templates = [];
+    verbose;
+    warnOnly;
+    constructor(options = {}) {
+        this.verbose = options.verbose || false;
+        this.warnOnly = options.warnOnly || false;
+    }
+    async validate() {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+        console.log("  EMAIL TEMPLATE VALIDATION (BLOCKING)");
+        console.log((0, console_chars_1.createDivider)(80, "double"));
+        // 1. Check template source file exists
+        this.checkSourceFileExists();
+        // 2. Parse and validate templates
+        if (this.errors.length === 0) {
+            this.parseTemplates();
+        }
+        // 3. Validate required templates exist
+        this.validateRequiredTemplates();
+        // 4. Validate template naming conventions
+        this.validateTemplateNaming();
+        // 5. Validate template fields
+        this.validateTemplateFields();
+        // 6. Check for DB query usage in sendgrid service
+        this.checkDbQueryUsage();
+        // 7. Validate template registry exists
+        this.checkRegistryExists();
+        // 8. Validate email footer has notification settings link
+        this.checkFooterNotificationSettingsLink();
+        // 9. Validate styling consistency (dark mode, colors, mobile)
+        this.validateStylingConsistency();
+        // Write findings for CI integration
+        (0, findings_writer_1.writeFindings)([
+            ...this.errors.map((e) => ({
+                severity: "error",
+                message: e.message,
+                file: e.file,
+                line: e.line,
+                code: e.code,
+            })),
+            ...this.warnings.map((w) => ({
+                severity: "warning",
+                message: w.message,
+                file: w.file,
+                line: w.line,
+                code: w.code,
+            })),
+        ]);
+        this.printReport();
+        if (this.warnOnly) {
+            return true;
+        }
+        return this.errors.length === 0;
+    }
+    checkSourceFileExists() {
+        const filePath = path.join(process.cwd(), CONFIG.templateSourceFile);
+        if (!fs.existsSync(filePath)) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_SOURCE",
+                message: `Template source file not found: ${CONFIG.templateSourceFile}`,
+                file: CONFIG.templateSourceFile,
+            });
+        }
+    }
+    parseTemplates() {
+        const filePath = path.join(process.cwd(), CONFIG.templateSourceFile);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        // Simple regex-based parsing for template definitions
+        let currentTemplate = null;
+        let braceDepth = 0;
+        let inTemplateArray = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Detect start of template array
+            if (line.includes("emailTemplatesV2") && line.includes("[")) {
+                inTemplateArray = true;
+                continue;
+            }
+            if (!inTemplateArray)
+                continue;
+            // Count braces to track object boundaries
+            const openBraces = (line.match(/{/g) || []).length;
+            const closeBraces = (line.match(/}/g) || []).length;
+            // Start of new template object
+            if (braceDepth === 0 && openBraces > 0 && line.trim().startsWith("{")) {
+                currentTemplate = { lineNumber: lineNum };
+                braceDepth = openBraces - closeBraces;
+                continue;
+            }
+            if (currentTemplate) {
+                braceDepth += openBraces - closeBraces;
+                // Parse template fields
+                const typeMatch = line.match(/templateType:\s*["']([^"']+)["']/);
+                if (typeMatch)
+                    currentTemplate.templateType = typeMatch[1];
+                const versionMatch = line.match(/version:\s*["']?([^"',\s]+)["']?/);
+                if (versionMatch)
+                    currentTemplate.version = versionMatch[1];
+                if (line.includes("subject:"))
+                    currentTemplate.hasSubject = true;
+                if (line.includes("htmlContent:"))
+                    currentTemplate.hasHtmlContent = true;
+                if (line.includes("textContent:"))
+                    currentTemplate.hasTextContent = true;
+                const activeMatch = line.match(/isActive:\s*(true|false)/);
+                if (activeMatch)
+                    currentTemplate.isActive = activeMatch[1] === "true";
+                // End of template object
+                if (braceDepth === 0) {
+                    if (currentTemplate.templateType) {
+                        this.templates.push(currentTemplate);
+                    }
+                    currentTemplate = null;
+                }
+            }
+            // End of template array
+            if (line.includes("];") && inTemplateArray) {
+                break;
+            }
+        }
+        if (this.verbose) {
+            console.log(`\n${console_chars_1.emoji.folder} Found ${this.templates.length} templates in source file\n`);
+        }
+    }
+    validateRequiredTemplates() {
+        const templateTypes = new Set(this.templates.map((t) => t.templateType));
+        for (const required of CONFIG.requiredTemplates) {
+            if (!templateTypes.has(required)) {
+                this.errors.push({
+                    type: "error",
+                    code: "MISSING_REQUIRED",
+                    message: `Required template missing: ${required}`,
+                    file: CONFIG.templateSourceFile,
+                });
+            }
+        }
+    }
+    validateTemplateNaming() {
+        for (const template of this.templates) {
+            if (!CONFIG.templateNamePattern.test(template.templateType)) {
+                this.errors.push({
+                    type: "error",
+                    code: "INVALID_NAME",
+                    message: `Template name must be SCREAMING_SNAKE_CASE: ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+            // Warn about unknown template types
+            if (!CONFIG.knownTemplateTypes.includes(template.templateType)) {
+                this.warnings.push({
+                    type: "warning",
+                    code: "UNKNOWN_TYPE",
+                    message: `Unknown template type (add to knownTemplateTypes): ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+        }
+    }
+    validateTemplateFields() {
+        for (const template of this.templates) {
+            if (!template.hasSubject) {
+                this.errors.push({
+                    type: "error",
+                    code: "MISSING_SUBJECT",
+                    message: `Template missing subject: ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+            if (!template.hasHtmlContent) {
+                this.errors.push({
+                    type: "error",
+                    code: "MISSING_HTML",
+                    message: `Template missing htmlContent: ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+            if (!template.hasTextContent) {
+                this.warnings.push({
+                    type: "warning",
+                    code: "MISSING_TEXT",
+                    message: `Template missing textContent (accessibility): ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+            if (!template.isActive) {
+                this.warnings.push({
+                    type: "warning",
+                    code: "INACTIVE",
+                    message: `Template is not active: ${template.templateType}`,
+                    file: CONFIG.templateSourceFile,
+                    line: template.lineNumber,
+                });
+            }
+        }
+    }
+    checkDbQueryUsage() {
+        const filePath = path.join(process.cwd(), CONFIG.sendgridServiceFile);
+        if (!fs.existsSync(filePath))
+            return;
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        // Check sendLatestTemplateEmail doesn't use DB
+        let inSendLatest = false;
+        let braceDepth = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.includes("sendLatestTemplateEmail")) {
+                inSendLatest = true;
+                braceDepth = 0;
+            }
+            if (inSendLatest) {
+                braceDepth += (line.match(/{/g) || []).length;
+                braceDepth -= (line.match(/}/g) || []).length;
+                // Check for DB query patterns (should use local templates)
+                if (line.includes("prisma.systemEmailTemplates") &&
+                    !line.includes("@deprecated") &&
+                    !line.includes("// Legacy")) {
+                    this.errors.push({
+                        type: "error",
+                        code: "DB_QUERY_IN_SEND_LATEST",
+                        message: "sendLatestTemplateEmail should use local templates, not DB queries",
+                        file: CONFIG.sendgridServiceFile,
+                        line: i + 1,
+                    });
+                }
+                if (braceDepth === 0 && line.includes("}")) {
+                    inSendLatest = false;
+                }
+            }
+        }
+        // Verify getTemplate import exists
+        if (!content.includes("import { getTemplate }") && !content.includes("import {getTemplate}")) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_IMPORT",
+                message: "sendgrid-service.ts must import getTemplate from @/lib/email-templates",
+                file: CONFIG.sendgridServiceFile,
+            });
+        }
+    }
+    checkRegistryExists() {
+        const filePath = path.join(process.cwd(), CONFIG.templateRegistryFile);
+        if (!fs.existsSync(filePath)) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_REGISTRY",
+                message: `Template registry not found: ${CONFIG.templateRegistryFile}`,
+                file: CONFIG.templateRegistryFile,
+            });
+        }
+    }
+    checkFooterNotificationSettingsLink() {
+        const componentsFile = "lib/email-template-components.ts";
+        const filePath = path.join(process.cwd(), componentsFile);
+        if (!fs.existsSync(filePath)) {
+            this.warnings.push({
+                type: "warning",
+                code: "MISSING_COMPONENTS",
+                message: `Email components file not found: ${componentsFile}`,
+                file: componentsFile,
+            });
+            return;
+        }
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        // Check for notification settings link in footer
+        let foundNotificationLink = false;
+        let inFooterFunction = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.includes("generateEmailFooter")) {
+                inFooterFunction = true;
+            }
+            if (inFooterFunction) {
+                // Check for notification settings link
+                if (line.includes(CONFIG.footerNotificationSettingsLink) &&
+                    (line.includes("Notification Settings") || line.includes("Email Preferences"))) {
+                    foundNotificationLink = true;
+                    break;
+                }
+                // End of function
+                if (line.trim() === "}" && inFooterFunction) {
+                    break;
+                }
+            }
+        }
+        if (!foundNotificationLink) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_NOTIFICATION_LINK",
+                message: `Email footer must include notification settings link to ${CONFIG.footerNotificationSettingsLink}`,
+                file: componentsFile,
+            });
+        }
+    }
+    validateStylingConsistency() {
+        const componentsFile = CONFIG.emailComponentsFile;
+        const filePath = path.join(process.cwd(), componentsFile);
+        if (!fs.existsSync(filePath)) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_COMPONENTS_FILE",
+                message: `Email components file not found: ${componentsFile}`,
+                file: componentsFile,
+            });
+            return;
+        }
+        const content = fs.readFileSync(filePath, "utf-8");
+        // Check for forbidden old colors (blue scheme)
+        for (const forbiddenColor of CONFIG.styling.forbiddenColors) {
+            if (content.toLowerCase().includes(forbiddenColor.toLowerCase())) {
+                this.errors.push({
+                    type: "error",
+                    code: "FORBIDDEN_COLOR",
+                    message: `Forbidden old color scheme found: ${forbiddenColor}. Use primary indigo (#4F46E5) instead.`,
+                    file: componentsFile,
+                });
+            }
+        }
+        // Check for primary brand color
+        const hasPrimaryColor = content.includes(CONFIG.styling.primaryColor) ||
+            content.includes(CONFIG.styling.primaryColorAlt);
+        if (!hasPrimaryColor) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_PRIMARY_COLOR",
+                message: `Primary brand color ${CONFIG.styling.primaryColor} not found in email components`,
+                file: componentsFile,
+            });
+        }
+        // Check for dark mode meta tags in wrapEmailContent
+        let hasDarkModeMetaTags = false;
+        for (const metaTag of CONFIG.styling.darkModeMetaTags) {
+            if (content.includes(metaTag)) {
+                hasDarkModeMetaTags = true;
+                break;
+            }
+        }
+        if (!hasDarkModeMetaTags) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_DARK_MODE_META",
+                message: 'Dark mode meta tags missing. Add: <meta name="color-scheme" content="light dark" />',
+                file: componentsFile,
+            });
+        }
+        // Check for dark mode CSS
+        if (!content.includes(CONFIG.styling.darkModeCssPattern)) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_DARK_MODE_CSS",
+                message: `Dark mode CSS missing. Add: ${CONFIG.styling.darkModeCssPattern} media query`,
+                file: componentsFile,
+            });
+        }
+        // Check for mobile responsive CSS
+        if (!content.includes(CONFIG.styling.mobileResponsivePattern)) {
+            this.errors.push({
+                type: "error",
+                code: "MISSING_MOBILE_CSS",
+                message: `Mobile responsive CSS missing. Add: ${CONFIG.styling.mobileResponsivePattern} media query`,
+                file: componentsFile,
+            });
+        }
+        // Check for required structural classes
+        for (const requiredClass of CONFIG.styling.requiredClasses) {
+            if (!content.includes(`.${requiredClass}`)) {
+                this.warnings.push({
+                    type: "warning",
+                    code: "MISSING_STRUCTURAL_CLASS",
+                    message: `Structural class ".${requiredClass}" not found in email styles`,
+                    file: componentsFile,
+                });
+            }
+        }
+        // Also validate preview HTML files in email-templates folder
+        this.validatePreviewFiles();
+    }
+    validatePreviewFiles() {
+        const previewDir = path.join(process.cwd(), "email-templates");
+        if (!fs.existsSync(previewDir)) {
+            return; // Preview files are optional
+        }
+        const files = fs.readdirSync(previewDir).filter((f) => f.endsWith(".html"));
+        for (const file of files) {
+            const filePath = path.join(previewDir, file);
+            const content = fs.readFileSync(filePath, "utf-8");
+            const relativePath = `email-templates/${file}`;
+            // Check for forbidden old colors
+            for (const forbiddenColor of CONFIG.styling.forbiddenColors) {
+                if (content.toLowerCase().includes(forbiddenColor.toLowerCase())) {
+                    this.errors.push({
+                        type: "error",
+                        code: "PREVIEW_FORBIDDEN_COLOR",
+                        message: `Forbidden old color ${forbiddenColor} in preview file. Use #4F46E5 instead.`,
+                        file: relativePath,
+                    });
+                }
+            }
+            // Check for dark mode meta tags
+            let hasDarkModeMeta = false;
+            for (const metaTag of CONFIG.styling.darkModeMetaTags) {
+                if (content.includes(metaTag)) {
+                    hasDarkModeMeta = true;
+                    break;
+                }
+            }
+            if (!hasDarkModeMeta) {
+                this.errors.push({
+                    type: "error",
+                    code: "PREVIEW_MISSING_DARK_MODE_META",
+                    message: "Preview file missing dark mode meta tags",
+                    file: relativePath,
+                });
+            }
+            // Check for dark mode CSS
+            if (!content.includes(CONFIG.styling.darkModeCssPattern)) {
+                this.errors.push({
+                    type: "error",
+                    code: "PREVIEW_MISSING_DARK_MODE_CSS",
+                    message: "Preview file missing dark mode CSS",
+                    file: relativePath,
+                });
+            }
+            // Check for mobile responsive CSS
+            if (!content.includes(CONFIG.styling.mobileResponsivePattern)) {
+                this.errors.push({
+                    type: "error",
+                    code: "PREVIEW_MISSING_MOBILE_CSS",
+                    message: "Preview file missing mobile responsive CSS",
+                    file: relativePath,
+                });
+            }
+            // Check copyright year (should be current or next year)
+            const currentYear = new Date().getFullYear();
+            const copyrightPattern = /©\s*(\d{4})/;
+            const match = content.match(copyrightPattern);
+            if (match) {
+                const year = parseInt(match[1], 10);
+                if (year < currentYear - 1) {
+                    this.warnings.push({
+                        type: "warning",
+                        code: "OUTDATED_COPYRIGHT",
+                        message: `Copyright year ${year} is outdated. Update to ${currentYear}.`,
+                        file: relativePath,
+                    });
+                }
+            }
+        }
+    }
+    printReport() {
+        console.log(`\n${console_chars_1.emoji.chart} VALIDATION STATS:`);
+        console.log(`   Templates found:  ${this.templates.length}`);
+        console.log(`   Errors:           ${this.errors.length}`);
+        console.log(`   Warnings:         ${this.warnings.length}`);
+        if (this.verbose && this.templates.length > 0) {
+            console.log(`\n${console_chars_1.emoji.folder} TEMPLATES:`);
+            for (const t of this.templates) {
+                const status = t.isActive ? console_chars_1.emoji.success : console_chars_1.emoji.warning;
+                console.log(`   ${status} ${t.templateType} (v${t.version})`);
+            }
+        }
+        if (this.errors.length > 0) {
+            console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+            console.log(`${console_chars_1.emoji.error} ERRORS: ${this.errors.length}`);
+            console.log((0, console_chars_1.createDivider)(80, "light"));
+            for (const error of this.errors) {
+                const loc = error.line ? `:${error.line}` : "";
+                console.log(`   ${console_chars_1.emoji.error} [${error.code}] ${error.message}`);
+                if (error.file)
+                    console.log(`      ${error.file}${loc}`);
+            }
+        }
+        if (this.warnings.length > 0) {
+            console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+            console.log(`${console_chars_1.emoji.warning} WARNINGS: ${this.warnings.length}`);
+            console.log((0, console_chars_1.createDivider)(80, "light"));
+            for (const warning of this.warnings) {
+                const loc = warning.line ? `:${warning.line}` : "";
+                console.log(`   ${console_chars_1.emoji.warning} [${warning.code}] ${warning.message}`);
+                if (warning.file)
+                    console.log(`      ${warning.file}${loc}`);
+            }
+        }
+        // Summary
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+        if (this.errors.length === 0) {
+            console.log(`${console_chars_1.emoji.success} EMAIL TEMPLATE VALIDATION PASSED`);
+        }
+        else if (this.warnOnly) {
+            console.log(`${console_chars_1.emoji.warning} VALIDATION COMPLETED (warning mode - not blocking)`);
+        }
+        else {
+            console.log(`${console_chars_1.emoji.error} EMAIL TEMPLATE VALIDATION FAILED`);
+            console.log(`   ${this.errors.length} error(s) must be fixed before build.`);
+        }
+        console.log((0, console_chars_1.createDivider)(80, "double"));
+        // Help
+        console.log("\n📖 EMAIL TEMPLATE RULES:");
+        console.log(`   ${console_chars_1.chars.bullet} Templates defined in: lib/seed-data/email-templates-v2.ts`);
+        console.log(`   ${console_chars_1.chars.bullet} Registry at: lib/email-templates/index.ts`);
+        console.log(`   ${console_chars_1.chars.bullet} Names: SCREAMING_SNAKE_CASE (ORDER_CONFIRMED)`);
+        console.log(`   ${console_chars_1.chars.bullet} Required: subject, htmlContent, textContent`);
+        console.log(`   ${console_chars_1.chars.bullet} No DB queries in sendLatestTemplateEmail`);
+        console.log(`   ${console_chars_1.chars.bullet} Footer must include notification settings link`);
+        console.log(`\n🎨 STYLING REQUIREMENTS:`);
+        console.log(`   ${console_chars_1.chars.bullet} Primary color: #4F46E5 (indigo)`);
+        console.log(`   ${console_chars_1.chars.bullet} Forbidden: #1976d2, #1565c0 (old blue)`);
+        console.log(`   ${console_chars_1.chars.bullet} Dark mode: meta tags + CSS media query`);
+        console.log(`   ${console_chars_1.chars.bullet} Mobile: @media (max-width: 600px)`);
+        console.log(`   ${console_chars_1.chars.bullet} Structure: email-wrapper, header, content, footer`);
+        console.log(`\n${console_chars_1.emoji.docs} DOCS: email-templates/README.md\n`);
+    }
+}
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// CLI
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const warnOnly = args.includes("--warn") || args.includes("--warning");
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const validator = new EmailTemplateValidator({ verbose, warnOnly });
+    const passed = await validator.validate();
+    process.exit(passed ? 0 : 1);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=email-template-validation.js.map