@empline/preflight 1.1.56 → 1.1.58

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

@@ -0,0 +1,456 @@
+#!/usr/bin/env node
+"use strict";
+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.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+/**
+ * Email Validation Preflight (BLOCKING)
+ *
+ * Validates email implementation best practices:
+ *
+ * 1. Template Validation:
+ *    - Email templates have required variables defined
+ *    - Templates use consistent branding
+ *    - Plain text alternatives exist
+ *
+ * 2. Send Operation Safety:
+ *    - Email sending has error handling
+ *    - Rate limiting considerations
+ *    - Retry logic for transient failures
+ *
+ * 3. Content Security:
+ *    - No sensitive data in email bodies
+ *    - Unsubscribe links in marketing emails
+ *    - Reply-to addresses configured
+ *
+ * 4. Delivery Tracking:
+ *    - Delivery status tracking for critical emails
+ *    - Bounce handling
+ *    - Open/click tracking where appropriate
+ *
+ * 5. Template Variables:
+ *    - All template variables are properly typed
+ *    - Required variables are validated before send
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+exports.id = "email/email-validation";
+exports.name = "Email Validation";
+exports.description = "Validates email templates, sending logic, and best practices";
+exports.category = "email";
+exports.blocking = true;
+exports.tags = ["email", "templates", "notifications", "transactional"];
+function getLineNumber(content, index) {
+    return content.substring(0, index).split("\n").length;
+}
+async function checkEmailTemplates() {
+    const issues = [];
+    // Find email template files
+    const templateFiles = await (0, glob_1.glob)([
+        "emails/**/*.tsx",
+        "emails/**/*.ts",
+        "lib/emails/**/*.tsx",
+        "lib/email/**/*.tsx",
+        "components/emails/**/*.tsx",
+        "app/api/email/**/*.ts",
+    ], {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    if (templateFiles.length === 0) {
+        // Check if there's any email functionality
+        const hasEmailPackage = fs.existsSync(path.join(process.cwd(), "node_modules", "resend")) ||
+            fs.existsSync(path.join(process.cwd(), "node_modules", "@sendgrid")) ||
+            fs.existsSync(path.join(process.cwd(), "node_modules", "nodemailer")) ||
+            fs.existsSync(path.join(process.cwd(), "node_modules", "@react-email"));
+        if (!hasEmailPackage) {
+            // No email functionality
+            return issues;
+        }
+    }
+    for (const file of templateFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Check for React Email templates
+        if (file.endsWith(".tsx") && content.includes("@react-email")) {
+            // Check for preview text
+            const hasPreview = content.includes("Preview") || content.includes("previewText");
+            if (!hasPreview) {
+                issues.push({
+                    rule: "email-preview-text",
+                    message: "Email template missing preview text",
+                    file: relativePath,
+                    severity: "warning",
+                    suggestion: "Add Preview component for email preview text",
+                });
+            }
+            // Check for unsubscribe link (for marketing-type emails)
+            const isMarketingEmail = /newsletter|promo|marketing|campaign/i.test(relativePath) ||
+                /newsletter|promo|marketing|campaign/i.test(content);
+            if (isMarketingEmail) {
+                const hasUnsubscribe = /unsubscribe/i.test(content);
+                if (!hasUnsubscribe) {
+                    issues.push({
+                        rule: "email-unsubscribe-link",
+                        message: "Marketing email template missing unsubscribe link",
+                        file: relativePath,
+                        severity: "error",
+                        suggestion: "Add unsubscribe link for CAN-SPAM compliance",
+                    });
+                }
+            }
+            // Check for proper typing of props
+            const hasTypedProps = /interface\s+\w+Props|type\s+\w+Props|Props\s*=/.test(content);
+            if (!hasTypedProps) {
+                issues.push({
+                    rule: "email-typed-props",
+                    message: "Email template props may not be typed",
+                    file: relativePath,
+                    severity: "warning",
+                    suggestion: "Define TypeScript interface for email template props",
+                });
+            }
+        }
+    }
+    return issues;
+}
+async function checkEmailSending() {
+    const issues = [];
+    // Find email sending code
+    const sendFiles = await (0, glob_1.glob)([
+        "lib/**/send*.ts",
+        "lib/**/email*.ts",
+        "app/api/**/email/**/*.ts",
+        "app/api/**/send/**/*.ts",
+    ], {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    for (const file of sendFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Check for email sending patterns
+        const hasSendEmail = /\.send\(|sendEmail|resend\.emails\.send|sendMail|transporter\.sendMail/i.test(content);
+        if (!hasSendEmail)
+            continue;
+        // Check for error handling
+        const hasTryCatch = /try\s*\{[\s\S]*?sendEmail[\s\S]*?\}\s*catch/i.test(content) ||
+            /try\s*\{[\s\S]*?\.send\([\s\S]*?\}\s*catch/i.test(content);
+        const hasAwaitWithCatch = /await\s+.*send.*\.catch/i.test(content);
+        if (!hasTryCatch && !hasAwaitWithCatch) {
+            issues.push({
+                rule: "email-error-handling",
+                message: "Email sending may not have proper error handling",
+                file: relativePath,
+                severity: "warning",
+                suggestion: "Wrap email sending in try/catch for error handling",
+            });
+        }
+        // Check for from address configuration
+        const hasFromAddress = /from\s*:|"from"|'from'|FROM/i.test(content);
+        if (!hasFromAddress) {
+            issues.push({
+                rule: "email-from-address",
+                message: "Email sending may not specify from address",
+                file: relativePath,
+                severity: "warning",
+                suggestion: "Always specify a from address for emails",
+            });
+        }
+        // Check for reply-to (good practice)
+        const hasReplyTo = /reply_?to|replyTo/i.test(content);
+        if (!hasReplyTo) {
+            issues.push({
+                rule: "email-reply-to",
+                message: "Email sending doesn't specify reply-to address",
+                file: relativePath,
+                severity: "info",
+                suggestion: "Consider adding reply-to address for customer emails",
+            });
+        }
+    }
+    return issues;
+}
+async function checkEmailSecurity() {
+    const issues = [];
+    // Find all email-related files
+    const emailFiles = await (0, glob_1.glob)([
+        "lib/**/email*.ts",
+        "emails/**/*.tsx",
+        "app/api/**/email/**/*.ts",
+    ], {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    for (const file of emailFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Check for sensitive data in email content
+        const sensitivePatterns = [
+            /password\s*:\s*[^,}]+/i,
+            /creditCard|cardNumber/i,
+            /ssn|socialSecurity/i,
+            /\bpin\b\s*:\s*[^,}]+/i,
+        ];
+        for (const pattern of sensitivePatterns) {
+            if (pattern.test(content)) {
+                const match = content.match(pattern);
+                if (match) {
+                    // Check if it's just a variable name or actual content
+                    const lineStart = content.lastIndexOf("\n", match.index || 0) + 1;
+                    const line = content.substring(lineStart, content.indexOf("\n", match.index || 0));
+                    // Skip if it's in an import, type definition, or comment
+                    if (!/import|type\s|interface\s|\/\//.test(line)) {
+                        issues.push({
+                            rule: "email-sensitive-data",
+                            message: "Email may contain sensitive data",
+                            file: relativePath,
+                            line: getLineNumber(content, match.index || 0),
+                            severity: "error",
+                            suggestion: "Never include passwords, credit cards, SSN, or PINs in emails",
+                        });
+                    }
+                }
+                break;
+            }
+        }
+        // Check for hardcoded email addresses (potential issues)
+        const hardcodedEmailRegex = /["'][a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}["']/g;
+        let match;
+        let hardcodedCount = 0;
+        while ((match = hardcodedEmailRegex.exec(content)) !== null) {
+            hardcodedCount++;
+        }
+        if (hardcodedCount > 3) {
+            issues.push({
+                rule: "email-hardcoded-addresses",
+                message: `Found ${hardcodedCount} hardcoded email addresses`,
+                file: relativePath,
+                severity: "warning",
+                suggestion: "Consider using environment variables or configuration for email addresses",
+            });
+        }
+    }
+    return issues;
+}
+async function checkDeliveryTracking() {
+    const issues = [];
+    // Find webhook handlers for email services
+    const webhookFiles = await (0, glob_1.glob)([
+        "app/api/webhooks/**/*.ts",
+        "app/api/**/webhook/**/*.ts",
+    ], {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    let hasEmailWebhook = false;
+    for (const file of webhookFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        // Check for email service webhooks
+        if (/resend|sendgrid|mailgun|postmark|ses/i.test(content)) {
+            hasEmailWebhook = true;
+            const relativePath = path.relative(process.cwd(), file);
+            // Check for bounce handling
+            const handlesBounces = /bounce|hard_bounce|soft_bounce/i.test(content);
+            if (!handlesBounces) {
+                issues.push({
+                    rule: "email-bounce-handling",
+                    message: "Email webhook may not handle bounces",
+                    file: relativePath,
+                    severity: "info",
+                    suggestion: "Handle bounce events to maintain list hygiene",
+                });
+            }
+            // Check for complaint handling
+            const handlesComplaints = /complaint|spam|abuse/i.test(content);
+            if (!handlesComplaints) {
+                issues.push({
+                    rule: "email-complaint-handling",
+                    message: "Email webhook may not handle spam complaints",
+                    file: relativePath,
+                    severity: "info",
+                    suggestion: "Handle spam complaints to maintain sender reputation",
+                });
+            }
+        }
+    }
+    // Check if email functionality exists but no webhooks
+    const emailFiles = await (0, glob_1.glob)("lib/**/email*.ts", { cwd: process.cwd() });
+    if (emailFiles.length > 0 && !hasEmailWebhook) {
+        issues.push({
+            rule: "email-delivery-webhooks",
+            message: "No email delivery webhooks found",
+            file: "app/api/webhooks/",
+            severity: "info",
+            suggestion: "Consider implementing webhooks for delivery tracking",
+        });
+    }
+    return issues;
+}
+async function checkEnvironmentConfig() {
+    const issues = [];
+    // Check for email-related environment variables
+    const envExample = path.join(process.cwd(), ".env.example");
+    const envLocal = path.join(process.cwd(), ".env.local");
+    let envContent = "";
+    if (fs.existsSync(envExample)) {
+        envContent = fs.readFileSync(envExample, "utf-8");
+    }
+    else if (fs.existsSync(envLocal)) {
+        envContent = fs.readFileSync(envLocal, "utf-8");
+    }
+    // Check if email config exists
+    const hasEmailConfig = /RESEND|SENDGRID|SMTP|MAIL|EMAIL/i.test(envContent);
+    if (hasEmailConfig) {
+        // Check for from email configuration
+        const hasFromEmail = /FROM_EMAIL|EMAIL_FROM|SENDER/i.test(envContent);
+        if (!hasFromEmail) {
+            issues.push({
+                rule: "email-from-env",
+                message: "No FROM email address in environment configuration",
+                file: ".env.example",
+                severity: "warning",
+                suggestion: "Add EMAIL_FROM or similar env variable for sender address",
+            });
+        }
+    }
+    return issues;
+}
+async function run() {
+    const startTime = Date.now();
+    const allIssues = [];
+    // Run all checks
+    allIssues.push(...await checkEmailTemplates());
+    allIssues.push(...await checkEmailSending());
+    allIssues.push(...await checkEmailSecurity());
+    allIssues.push(...await checkDeliveryTracking());
+    allIssues.push(...await checkEnvironmentConfig());
+    // Convert to findings
+    const findings = allIssues.map(issue => ({
+        level: issue.severity,
+        message: issue.message,
+        file: issue.file,
+        startLine: issue.line,
+        ruleId: issue.rule,
+        suggestion: issue.suggestion,
+    }));
+    const errors = findings.filter(f => f.level === "error");
+    const warnings = findings.filter(f => f.level === "warning");
+    const infos = findings.filter(f => f.level === "info");
+    return {
+        passed: errors.length === 0,
+        findings,
+        duration: Date.now() - startTime,
+        metadata: {
+            errors: errors.length,
+            warnings: warnings.length,
+            infos: infos.length,
+        },
+    };
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.memo} EMAIL VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const result = await run();
+    const { errors, warnings, infos } = result.metadata || {};
+    console.log(`\n${console_chars_1.emoji.search} Checking email implementation...`);
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Errors: ${errors}`);
+    console.log(`   Warnings: ${warnings}`);
+    console.log(`   Info: ${infos}`);
+    if (result.findings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.info} No email-related code found to validate`);
+        process.exit(0);
+    }
+    if (result.passed && warnings === 0) {
+        console.log(`\n${console_chars_1.emoji.success} EMAIL VALIDATION PASSED`);
+        console.log(`\nAll email best practices are followed.`);
+        process.exit(0);
+    }
+    // Print errors
+    const errorFindings = result.findings.filter(f => f.level === "error");
+    if (errorFindings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Errors (blocking):`);
+        for (const finding of errorFindings) {
+            console.log(`\n   ${finding.file}${finding.startLine ? `:${finding.startLine}` : ""}`);
+            console.log(`     ${finding.message}`);
+            if (finding.suggestion) {
+                console.log(`     ${console_chars_1.emoji.hint} ${finding.suggestion}`);
+            }
+        }
+    }
+    // Print warnings
+    const warningFindings = result.findings.filter(f => f.level === "warning");
+    if (warningFindings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} Warnings:`);
+        for (const finding of warningFindings.slice(0, 10)) {
+            console.log(`\n   ${finding.file}`);
+            console.log(`     ${finding.message}`);
+        }
+        if (warningFindings.length > 10) {
+            console.log(`\n   ... and ${warningFindings.length - 10} more warnings`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.info} Email Best Practices:`);
+    console.log(`   - Type email template props`);
+    console.log(`   - Handle sending errors gracefully`);
+    console.log(`   - Include unsubscribe links in marketing emails`);
+    console.log(`   - Never include sensitive data in emails`);
+    console.log(`   - Implement delivery webhooks for tracking`);
+    if (!result.passed) {
+        console.log(`\n${console_chars_1.emoji.error} EMAIL VALIDATION FAILED`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} EMAIL VALIDATION PASSED`);
+    process.exit(0);
+}
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=email-validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation.js","sourceRoot":"","sources":["../../../src/checks/email/email-validation.ts"],"names":[],"mappings":"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"}

package/dist/checks/observability/observability-validation.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "observability/observability-validation";
+export declare const name = "Observability Validation";
+export declare const description = "Validates error handling, logging, and monitoring best practices";
+export declare const category = "observability";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=observability-validation.d.ts.map

package/dist/checks/observability/observability-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/observability/observability-validation.ts"],"names":[],"mappings":";AAiCA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAG1E,eAAO,MAAM,EAAE,2CAA2C,CAAC;AAC3D,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,WAAW,qEAAqE,CAAC;AAC9F,eAAO,MAAM,QAAQ,kBAAkB,CAAC;AACxC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAsE,CAAC;AA2TxF,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAmCzD"}