@empline/preflight 1.1.56 → 1.1.58

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

@@ -0,0 +1,448 @@
+#!/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;
+/**
+ * Observability Validation Preflight (BLOCKING)
+ *
+ * Validates observability best practices for production-ready applications:
+ *
+ * 1. Error Boundaries:
+ *    - App has global error boundary (app/error.tsx)
+ *    - Critical routes have error boundaries
+ *    - Error boundaries log to monitoring service
+ *
+ * 2. Error Handling:
+ *    - API routes have try/catch with proper error responses
+ *    - Server actions handle errors gracefully
+ *    - No unhandled promise rejections
+ *
+ * 3. Logging:
+ *    - Critical operations have logging
+ *    - No console.log in production code (use proper logger)
+ *    - Sensitive data not logged
+ *
+ * 4. Performance Tracking:
+ *    - Web vitals tracking present
+ *    - Database query performance monitoring
+ *    - API response time tracking
+ *
+ * 5. Health Checks:
+ *    - Health check endpoint exists
+ *    - Database connectivity check
+ */
+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 = "observability/observability-validation";
+exports.name = "Observability Validation";
+exports.description = "Validates error handling, logging, and monitoring best practices";
+exports.category = "observability";
+exports.blocking = true;
+exports.tags = ["observability", "errors", "logging", "monitoring", "performance"];
+function getLineNumber(content, index) {
+    return content.substring(0, index).split("\n").length;
+}
+async function checkErrorBoundaries() {
+    const issues = [];
+    const cwd = process.cwd();
+    // Check for global error boundary
+    const globalErrorPath = path.join(cwd, "app", "error.tsx");
+    if (!fs.existsSync(globalErrorPath)) {
+        issues.push({
+            rule: "global-error-boundary",
+            message: "Missing global error boundary (app/error.tsx)",
+            file: "app/error.tsx",
+            severity: "error",
+            suggestion: "Create app/error.tsx to handle uncaught errors gracefully",
+        });
+    }
+    else {
+        // Check error boundary quality
+        const content = fs.readFileSync(globalErrorPath, "utf-8");
+        // Should be a client component
+        if (!content.includes('"use client"') && !content.includes("'use client'")) {
+            issues.push({
+                rule: "error-boundary-client",
+                message: "Error boundary should be a client component",
+                file: "app/error.tsx",
+                severity: "error",
+                suggestion: 'Add "use client" directive at the top',
+            });
+        }
+        // Should have reset functionality
+        if (!content.includes("reset")) {
+            issues.push({
+                rule: "error-boundary-reset",
+                message: "Error boundary missing reset functionality",
+                file: "app/error.tsx",
+                severity: "warning",
+                suggestion: "Add reset() call to allow users to retry",
+            });
+        }
+        // Should log errors (check for common logging patterns)
+        const hasLogging = /console\.error|logger\.|Sentry\.|captureException|reportError|logError/i.test(content);
+        if (!hasLogging) {
+            issues.push({
+                rule: "error-boundary-logging",
+                message: "Error boundary should log errors for monitoring",
+                file: "app/error.tsx",
+                severity: "warning",
+                suggestion: "Add error logging to capture errors in production",
+            });
+        }
+    }
+    // Check for global-error.tsx (handles errors in root layout)
+    const globalGlobalErrorPath = path.join(cwd, "app", "global-error.tsx");
+    if (!fs.existsSync(globalGlobalErrorPath)) {
+        issues.push({
+            rule: "global-global-error",
+            message: "Missing app/global-error.tsx for root layout errors",
+            file: "app/global-error.tsx",
+            severity: "warning",
+            suggestion: "Create app/global-error.tsx to handle errors in the root layout",
+        });
+    }
+    // Check for not-found.tsx
+    const notFoundPath = path.join(cwd, "app", "not-found.tsx");
+    if (!fs.existsSync(notFoundPath)) {
+        issues.push({
+            rule: "not-found-page",
+            message: "Missing custom 404 page (app/not-found.tsx)",
+            file: "app/not-found.tsx",
+            severity: "warning",
+            suggestion: "Create app/not-found.tsx for better user experience",
+        });
+    }
+    return issues;
+}
+async function checkApiErrorHandling() {
+    const issues = [];
+    const apiFiles = await (0, glob_1.glob)("app/api/**/route.ts", {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    for (const file of apiFiles) {
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Check for try/catch in handler functions
+        const hasExportedHandlers = /export\s+(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE)/g.test(content);
+        if (hasExportedHandlers) {
+            // Check if there's proper error handling
+            const hasTryCatch = /try\s*\{[\s\S]*?\}\s*catch/g.test(content);
+            const hasErrorResponse = /NextResponse\.json\s*\([^)]*(?:error|status:\s*[45]\d\d)/i.test(content) ||
+                /return\s+new\s+Response\s*\([^)]*(?:status:\s*[45]\d\d)/i.test(content);
+            if (!hasTryCatch && !hasErrorResponse) {
+                issues.push({
+                    rule: "api-error-handling",
+                    message: "API route missing error handling",
+                    file: relativePath,
+                    severity: "warning",
+                    suggestion: "Add try/catch blocks and return proper error responses",
+                });
+            }
+            // Check for unhandled async operations
+            const hasAwaitWithoutTry = /(?<!try\s*\{[^}]*)\bawait\s+(?!.*catch)/m.test(content);
+            if (hasAwaitWithoutTry && !hasTryCatch) {
+                issues.push({
+                    rule: "api-unhandled-async",
+                    message: "API route has await without try/catch",
+                    file: relativePath,
+                    severity: "warning",
+                    suggestion: "Wrap async operations in try/catch",
+                });
+            }
+        }
+    }
+    return issues;
+}
+async function checkLoggingPractices() {
+    const issues = [];
+    const codeFiles = await (0, glob_1.glob)([
+        "app/**/*.ts",
+        "app/**/*.tsx",
+        "lib/**/*.ts",
+    ], {
+        cwd: process.cwd(),
+        ignore: ["**/*.test.ts", "**/*.spec.ts", "**/node_modules/**"],
+        absolute: true,
+    });
+    let consoleLogCount = 0;
+    const consoleLogFiles = [];
+    for (const file of codeFiles) {
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Check for console.log (should use proper logger in production)
+        const consoleLogRegex = /console\.log\s*\(/g;
+        let match;
+        while ((match = consoleLogRegex.exec(content)) !== null) {
+            // Skip if it's in a comment or preflight-ignore
+            const lineStart = content.lastIndexOf("\n", match.index) + 1;
+            const line = content.substring(lineStart, content.indexOf("\n", match.index));
+            if (line.includes("//") || line.includes("preflight-ignore"))
+                continue;
+            consoleLogCount++;
+            if (!consoleLogFiles.includes(relativePath)) {
+                consoleLogFiles.push(relativePath);
+            }
+        }
+        // Check for logging sensitive data patterns
+        const sensitivePatterns = [
+            /console\.\w+\s*\([^)]*password/i,
+            /console\.\w+\s*\([^)]*secret/i,
+            /console\.\w+\s*\([^)]*token(?!Type)/i,
+            /console\.\w+\s*\([^)]*apiKey/i,
+            /logger\.\w+\s*\([^)]*password/i,
+        ];
+        for (const pattern of sensitivePatterns) {
+            if (pattern.test(content)) {
+                issues.push({
+                    rule: "sensitive-data-logging",
+                    message: "Potential sensitive data in logs",
+                    file: relativePath,
+                    severity: "error",
+                    suggestion: "Never log passwords, secrets, tokens, or API keys",
+                });
+                break;
+            }
+        }
+    }
+    // Report console.log usage summary
+    if (consoleLogCount > 10) {
+        issues.push({
+            rule: "console-log-usage",
+            message: `Found ${consoleLogCount} console.log statements in ${consoleLogFiles.length} files`,
+            file: consoleLogFiles[0] || "multiple files",
+            severity: "warning",
+            suggestion: "Consider using a structured logger for production code",
+        });
+    }
+    return issues;
+}
+async function checkHealthEndpoint() {
+    const issues = [];
+    const cwd = process.cwd();
+    // Check for health check endpoint
+    const healthPaths = [
+        path.join(cwd, "app", "api", "health", "route.ts"),
+        path.join(cwd, "app", "api", "healthz", "route.ts"),
+        path.join(cwd, "app", "api", "health-check", "route.ts"),
+        path.join(cwd, "pages", "api", "health.ts"),
+    ];
+    const hasHealthEndpoint = healthPaths.some(p => fs.existsSync(p));
+    if (!hasHealthEndpoint) {
+        issues.push({
+            rule: "health-endpoint",
+            message: "Missing health check endpoint",
+            file: "app/api/health/route.ts",
+            severity: "warning",
+            suggestion: "Create a /api/health endpoint for monitoring and load balancers",
+        });
+    }
+    else {
+        // Check health endpoint quality
+        const healthPath = healthPaths.find(p => fs.existsSync(p));
+        if (healthPath) {
+            const content = fs.readFileSync(healthPath, "utf-8");
+            const relativePath = path.relative(cwd, healthPath);
+            // Should check database connectivity
+            const checksDatabase = /prisma|database|db\./i.test(content);
+            if (!checksDatabase) {
+                issues.push({
+                    rule: "health-db-check",
+                    message: "Health endpoint doesn't check database connectivity",
+                    file: relativePath,
+                    severity: "info",
+                    suggestion: "Add database connectivity check to health endpoint",
+                });
+            }
+        }
+    }
+    return issues;
+}
+async function checkPerformanceMonitoring() {
+    const issues = [];
+    // Check for web vitals tracking
+    const webVitalsFiles = await (0, glob_1.glob)([
+        "app/**/web-vitals*.ts",
+        "lib/**/web-vitals*.ts",
+        "instrumentation.ts",
+        "app/layout.tsx",
+    ], {
+        cwd: process.cwd(),
+        absolute: true,
+    });
+    let hasWebVitals = false;
+    for (const file of webVitalsFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        if (content.includes("reportWebVitals") || content.includes("web-vitals") || content.includes("@vercel/speed-insights")) {
+            hasWebVitals = true;
+            break;
+        }
+    }
+    if (!hasWebVitals) {
+        issues.push({
+            rule: "web-vitals-tracking",
+            message: "No Web Vitals tracking detected",
+            file: "app/layout.tsx",
+            severity: "info",
+            suggestion: "Add @vercel/speed-insights or custom Web Vitals tracking",
+        });
+    }
+    // Check for analytics
+    const layoutPath = path.join(process.cwd(), "app", "layout.tsx");
+    if (fs.existsSync(layoutPath)) {
+        const content = fs.readFileSync(layoutPath, "utf-8");
+        const hasAnalytics = /Analytics|GoogleAnalytics|gtag|plausible|umami|posthog|@vercel\/analytics/i.test(content);
+        if (!hasAnalytics) {
+            issues.push({
+                rule: "analytics-tracking",
+                message: "No analytics tracking detected in root layout",
+                file: "app/layout.tsx",
+                severity: "info",
+                suggestion: "Consider adding analytics to track user behavior",
+            });
+        }
+    }
+    return issues;
+}
+async function run() {
+    const startTime = Date.now();
+    const allIssues = [];
+    // Run all checks
+    allIssues.push(...await checkErrorBoundaries());
+    allIssues.push(...await checkApiErrorHandling());
+    allIssues.push(...await checkLoggingPractices());
+    allIssues.push(...await checkHealthEndpoint());
+    allIssues.push(...await checkPerformanceMonitoring());
+    // 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.chart} OBSERVABILITY 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 observability practices...`);
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Errors: ${errors}`);
+    console.log(`   Warnings: ${warnings}`);
+    console.log(`   Info: ${infos}`);
+    if (result.passed && warnings === 0) {
+        console.log(`\n${console_chars_1.emoji.success} OBSERVABILITY VALIDATION PASSED`);
+        console.log(`\nAll observability best practices are followed.`);
+        process.exit(0);
+    }
+    // Group by rule
+    const findingsByRule = new Map();
+    for (const finding of result.findings) {
+        const ruleId = finding.ruleId || "unknown";
+        if (!findingsByRule.has(ruleId)) {
+            findingsByRule.set(ruleId, []);
+        }
+        findingsByRule.get(ruleId).push(finding);
+    }
+    // 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 (finding.suggestion) {
+                console.log(`     ${console_chars_1.emoji.hint} ${finding.suggestion}`);
+            }
+        }
+        if (warningFindings.length > 10) {
+            console.log(`\n   ... and ${warningFindings.length - 10} more warnings`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.info} Observability Best Practices:`);
+    console.log(`   - Global error boundary (app/error.tsx)`);
+    console.log(`   - API routes with try/catch and proper error responses`);
+    console.log(`   - Health check endpoint for monitoring`);
+    console.log(`   - No sensitive data in logs`);
+    console.log(`   - Web Vitals and analytics tracking`);
+    if (!result.passed) {
+        console.log(`\n${console_chars_1.emoji.error} OBSERVABILITY VALIDATION FAILED`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} OBSERVABILITY 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=observability-validation.js.map

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

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

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

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "seo/seo-validation";
+export declare const name = "SEO Validation";
+export declare const description = "Validates SEO best practices (metadata, Open Graph, structured data, technical SEO)";
+export declare const category = "seo";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=seo-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/seo/seo-validation.ts"],"names":[],"mappings":";AAiCA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAG1E,eAAO,MAAM,EAAE,uBAAuB,CAAC;AACvC,eAAO,MAAM,IAAI,mBAAmB,CAAC;AACrC,eAAO,MAAM,WAAW,wFAAwF,CAAC;AACjH,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAgE,CAAC;AAwUlF,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA0EzD"}