@empline/preflight 1.1.0

package/dist/checks/nextjs/essential-files-validation.js

@@ -0,0 +1,361 @@
+"use strict";
+/**
+ * Preflight: Essential Files Validation
+ *
+ * Validates that critical Next.js files exist before build:
+ * - Error pages (404, 500, error boundaries)
+ * - Layout and loading states
+ * - Configuration files
+ * - Security files
+ *
+ * Also validates content patterns:
+ * - Error pages must use UnifiedErrorState for consistency
+ * - Loading pages should use skeletons (not spinners)
+ *
+ * These files are essential for production reliability and user experience.
+ * Missing error pages cause poor UX when errors occur.
+ */
+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 = "nextjs/essential-files-validation";
+exports.name = "Essential Files Validation";
+exports.category = "nextjs";
+exports.blocking = true;
+exports.description = "Preflight: Essential Files Validation";
+exports.tags = ["nextjs", "validation"];
+const ESSENTIAL_FILES = [
+    // Error Handling (CRITICAL - blocking)
+    {
+        path: "app/not-found.tsx",
+        description: "Custom 404 page for missing routes",
+        blocking: true,
+        category: "error-handling",
+        mustContain: ["UnifiedErrorState"],
+    },
+    {
+        path: "app/error.tsx",
+        description: "Route-level error boundary (catches errors in route segments)",
+        blocking: true,
+        category: "error-handling",
+        mustContain: ["UnifiedErrorState", '"use client"'],
+    },
+    {
+        path: "app/global-error.tsx",
+        description: "Root error boundary (catches errors in root layout)",
+        blocking: true,
+        category: "error-handling",
+        mustContain: ["UnifiedErrorState", '"use client"', "<html", "<body"],
+    },
+    {
+        path: "app/forbidden/page.tsx",
+        description: "Custom 403 forbidden page",
+        blocking: false,
+        category: "error-handling",
+        mustContain: ["UnifiedErrorState"],
+    },
+    // Layout & Loading (CRITICAL - blocking)
+    {
+        path: "app/layout.tsx",
+        description: "Root layout with providers and global structure",
+        blocking: true,
+        category: "layout",
+        mustContain: ["<html", "<body", "children"],
+    },
+    {
+        path: "app/loading.tsx",
+        description: "Root loading state (shows during navigation)",
+        blocking: true,
+        category: "layout",
+        mustNotContain: [
+            {
+                pattern: "CircularProgress",
+                reason: "Use skeletons instead of spinners for loading states",
+            },
+        ],
+    },
+    // Configuration (CRITICAL - blocking)
+    {
+        path: "next.config.js",
+        description: "Next.js configuration",
+        blocking: true,
+        category: "config",
+    },
+    {
+        path: "tsconfig.json",
+        description: "TypeScript configuration",
+        blocking: true,
+        category: "config",
+    },
+    {
+        path: "package.json",
+        description: "Package manifest",
+        blocking: true,
+        category: "config",
+    },
+    // Security (blocking)
+    {
+        path: "SECURITY.md",
+        description: "Security policy for vulnerability reporting",
+        blocking: true,
+        category: "security",
+    },
+    // SEO (non-blocking warnings)
+    {
+        path: "app/robots.ts",
+        description: "Robots.txt generation for search engines",
+        blocking: false,
+        category: "seo",
+    },
+    {
+        path: "app/sitemap.ts",
+        description: "Sitemap generation for search engines",
+        blocking: false,
+        category: "seo",
+    },
+    // Additional recommended files (non-blocking)
+    {
+        path: "app/providers.tsx",
+        description: "Client-side providers wrapper",
+        blocking: false,
+        category: "layout",
+    },
+    {
+        path: ".env.example",
+        description: "Environment variable template for developers",
+        blocking: false,
+        category: "config",
+    },
+    {
+        path: "README.md",
+        description: "Project documentation",
+        blocking: false,
+        category: "config",
+    },
+];
+// Critical routes that should have their own error.tsx for better error isolation
+const CRITICAL_ROUTE_ERROR_BOUNDARIES = [
+    { route: "app/checkout/error.tsx", description: "Checkout - payment flow" },
+    { route: "app/dashboard/error.tsx", description: "User dashboard" },
+    { route: "app/admin/error.tsx", description: "Admin panel" },
+    { route: "app/account/error.tsx", description: "Account settings" },
+];
+function validateFileContent(filePath, file) {
+    const issues = [];
+    const cwd = process.cwd();
+    const fullPath = path.join(cwd, filePath);
+    if (!fs.existsSync(fullPath)) {
+        return issues; // Can't validate content if file doesn't exist
+    }
+    const content = fs.readFileSync(fullPath, "utf-8");
+    // Check required patterns
+    if (file.mustContain) {
+        for (const pattern of file.mustContain) {
+            if (!content.includes(pattern)) {
+                issues.push({
+                    type: "missing-pattern",
+                    pattern,
+                    reason: `File should contain "${pattern}" for consistency`,
+                });
+            }
+        }
+    }
+    // Check forbidden patterns
+    if (file.mustNotContain) {
+        for (const { pattern, reason } of file.mustNotContain) {
+            if (content.includes(pattern)) {
+                issues.push({
+                    type: "forbidden-pattern",
+                    pattern,
+                    reason,
+                });
+            }
+        }
+    }
+    return issues;
+}
+function validateEssentialFiles() {
+    const cwd = process.cwd();
+    return ESSENTIAL_FILES.map((file) => {
+        const exists = fs.existsSync(path.join(cwd, file.path));
+        const contentIssues = exists ? validateFileContent(file.path, file) : [];
+        return { file, exists, contentIssues };
+    });
+}
+function groupByCategory(results) {
+    const grouped = new Map();
+    for (const result of results) {
+        const category = result.file.category;
+        if (!grouped.has(category)) {
+            grouped.set(category, []);
+        }
+        grouped.get(category).push(result);
+    }
+    return grouped;
+}
+// MAIN
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log("Validating essential files...\n");
+    const results = validateEssentialFiles();
+    const grouped = groupByCategory(results);
+    const findings = [];
+    let blockingMissing = 0;
+    let warningMissing = 0;
+    let contentIssueCount = 0;
+    const categoryLabels = {
+        "error-handling": "Error Handling",
+        layout: "Layout & Loading",
+        config: "Configuration",
+        security: "Security",
+        seo: "SEO",
+    };
+    // Process each category
+    for (const [category, categoryResults] of grouped) {
+        const label = categoryLabels[category] || category;
+        console.log(`${label}:`);
+        for (const result of categoryResults) {
+            const hasContentIssues = result.contentIssues.length > 0;
+            let status;
+            let suffix;
+            if (!result.exists) {
+                status = result.file.blocking ? "✗" : "${emoji.warning}";
+                suffix = result.file.blocking ? " (MISSING - BLOCKING)" : " (missing)";
+            }
+            else if (hasContentIssues) {
+                status = "${emoji.warning}";
+                suffix = " (content issues)";
+            }
+            else {
+                status = "✓";
+                suffix = "";
+            }
+            console.log(`  ${status} ${result.file.path}${suffix}`);
+            // Show content issues inline
+            if (hasContentIssues) {
+                for (const issue of result.contentIssues) {
+                    const issueType = issue.type === "missing-pattern" ? "missing" : "forbidden";
+                    console.log(`      ${console_chars_1.chars.treeCorner} ${issueType}: "${issue.pattern}" - ${issue.reason}`);
+                    contentIssueCount++;
+                    findings.push({
+                        message: `${result.file.path}: ${issue.reason}`,
+                        severity: "warning",
+                        code: `CONTENT_${issue.type.toUpperCase().replace("-", "_")}`,
+                        file: result.file.path,
+                    });
+                }
+            }
+            if (!result.exists) {
+                if (result.file.blocking) {
+                    blockingMissing++;
+                }
+                else {
+                    warningMissing++;
+                }
+                findings.push({
+                    message: `Missing essential file: ${result.file.path} - ${result.file.description}`,
+                    severity: result.file.blocking ? "error" : "warning",
+                    code: `MISSING_${result.file.category.toUpperCase().replace("-", "_")}`,
+                    file: result.file.path,
+                });
+            }
+        }
+        console.log("");
+    }
+    // Check critical route error boundaries (non-blocking, informational)
+    console.log("Critical Route Error Boundaries:");
+    let missingCriticalRoutes = 0;
+    const cwd = process.cwd();
+    for (const route of CRITICAL_ROUTE_ERROR_BOUNDARIES) {
+        const exists = fs.existsSync(path.join(cwd, route.route));
+        const status = exists ? "✓" : "${emoji.warning}";
+        const suffix = exists ? "" : " (recommended)";
+        console.log(`  ${status} ${route.route}${suffix}`);
+        if (!exists) {
+            missingCriticalRoutes++;
+            findings.push({
+                message: `Missing error boundary for critical route: ${route.route} - ${route.description}`,
+                severity: "warning",
+                code: "MISSING_ROUTE_ERROR_BOUNDARY",
+                file: route.route,
+            });
+        }
+    }
+    console.log("");
+    // Write findings for SARIF/CI integration
+    (0, findings_writer_1.writeFindings)(findings);
+    // Summary
+    console.log(`${console_chars_1.box.horizontal}`.repeat(50));
+    const total = ESSENTIAL_FILES.length;
+    const present = total - blockingMissing - warningMissing;
+    if (blockingMissing === 0 &&
+        warningMissing === 0 &&
+        contentIssueCount === 0 &&
+        missingCriticalRoutes === 0) {
+        console.log(`${console_chars_1.chars.check} All ${total} essential files present and valid`);
+        console.log(`${console_chars_1.chars.check} All ${CRITICAL_ROUTE_ERROR_BOUNDARIES.length} critical route error boundaries present`);
+        process.exit(0);
+    }
+    if (blockingMissing > 0) {
+        console.log(`\n${console_chars_1.chars.cross} FAILED: ${blockingMissing} blocking file(s) missing`);
+        console.log(`  ${present}/${total} files present, ${warningMissing} warnings, ${contentIssueCount} content issues`);
+        console.log("\nBlocking files must exist for production builds.");
+        console.log("Create the missing files or check if they were accidentally deleted.");
+        process.exit(1);
+    }
+    // Only warnings
+    const warningCount = warningMissing + contentIssueCount + missingCriticalRoutes;
+    console.log(`\n${console_chars_1.emoji.warning} PASSED with ${warningCount} warning(s)`);
+    console.log(`  ${present}/${total} essential files present`);
+    if (contentIssueCount > 0) {
+        console.log(`  ${contentIssueCount} content pattern issue(s)`);
+    }
+    if (missingCriticalRoutes > 0) {
+        console.log(`  ${missingCriticalRoutes} critical route(s) missing error boundaries`);
+    }
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=essential-files-validation.js.map

package/dist/checks/nextjs/essential-files-validation.js.map

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

package/dist/checks/nextjs/ignore-build-errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Preflight: Ensure ignoreBuildErrors is never enabled
+ *
+ * ignoreBuildErrors: true in next.config.js allows TypeScript errors to slip
+ * through to production, causing runtime errors like "X is not defined".
+ *
+ * This preflight blocks deployment if ignoreBuildErrors is set to true.
+ */
+export declare const id = "nextjs/ignore-build-errors";
+export declare const name = "Ignore Build Errors";
+export declare const category = "nextjs";
+export declare const blocking = false;
+export declare const description = "Preflight: Ensure ignoreBuildErrors is never enabled";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=ignore-build-errors.d.ts.map

package/dist/checks/nextjs/ignore-build-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-build-errors.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/ignore-build-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAC1C,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAa,CAAC;AA+D/B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBzC"}

package/dist/checks/nextjs/ignore-build-errors.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Preflight: Ensure ignoreBuildErrors is never enabled
+ *
+ * ignoreBuildErrors: true in next.config.js allows TypeScript errors to slip
+ * through to production, causing runtime errors like "X is not defined".
+ *
+ * This preflight blocks deployment if ignoreBuildErrors is set to true.
+ */
+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 universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "nextjs/ignore-build-errors";
+exports.name = "Ignore Build Errors";
+exports.category = "nextjs";
+exports.blocking = false;
+exports.description = "Preflight: Ensure ignoreBuildErrors is never enabled";
+exports.tags = ["nextjs"];
+const NEXT_CONFIG_PATH = path.join(process.cwd(), "next.config.js");
+function checkIgnoreBuildErrors() {
+    if (!fs.existsSync(NEXT_CONFIG_PATH)) {
+        return {
+            passed: true,
+            message: "next.config.js not found (skipped)",
+        };
+    }
+    const content = fs.readFileSync(NEXT_CONFIG_PATH, "utf-8");
+    // Remove comments to avoid false positives from comment text
+    const contentWithoutComments = content
+        .replace(/\/\/.*$/gm, "") // Remove single-line comments
+        .replace(/\/\*[\s\S]*?\*\//g, ""); // Remove multi-line comments
+    // Check for ignoreBuildErrors: true (with various whitespace patterns)
+    const patterns = [/ignoreBuildErrors\s*:\s*true/, /["']ignoreBuildErrors["']\s*:\s*true/];
+    for (const pattern of patterns) {
+        if (pattern.test(contentWithoutComments)) {
+            return {
+                passed: false,
+                message: "CRITICAL: ignoreBuildErrors is set to true in next.config.js",
+                details: [
+                    "This allows TypeScript errors to slip through to production",
+                    "Runtime errors like 'X is not defined' will occur",
+                    "",
+                    "Fix: Set ignoreBuildErrors: false in next.config.js",
+                    "Then run: pnpm type-check to find and fix all TypeScript errors",
+                ],
+            };
+        }
+    }
+    // Also check for eslint.ignoreDuringBuilds while we're at it
+    const eslintPattern = /ignoreDuringBuilds\s*:\s*true/;
+    if (eslintPattern.test(contentWithoutComments)) {
+        return {
+            passed: false,
+            message: "WARNING: eslint.ignoreDuringBuilds is set to true",
+            details: [
+                "ESLint errors will not block builds",
+                "Consider setting to false for stricter builds",
+            ],
+        };
+    }
+    return {
+        passed: true,
+        message: "Build error checking is properly enforced",
+    };
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log("Checking next.config.js build error settings...\n");
+    const result = checkIgnoreBuildErrors();
+    if (result.passed) {
+        console.log(`PASS ${result.message}`);
+        process.exit(0);
+    }
+    else {
+        console.error(`FAIL ${result.message}`);
+        if (result.details) {
+            console.error("");
+            for (const detail of result.details) {
+                console.error(`   ${detail}`);
+            }
+        }
+        process.exit(1);
+    }
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=ignore-build-errors.js.map

package/dist/checks/nextjs/ignore-build-errors.js.map

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

package/dist/checks/nextjs/metadata-api-placement.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Metadata API Placement Preflight - BLOCKING
+ *
+ * Ensures Next.js metadata API functions are only exported from correct locations.
+ *
+ * PROBLEM THIS PREVENTS:
+ * - `generateSitemaps()` exported from route handlers causes:
+ *   "You cannot use different slug names for the same dynamic path ('__metadata_id__' !== 'id')"
+ * - This cryptic error breaks ALL dynamic routes, not just sitemaps
+ *
+ * RULES:
+ * - `generateSitemaps()` → Only in app/sitemap.ts (NOT in app/sitemap/[id]/route.ts)
+ * - `generateImageMetadata()` → Only in opengraph-image.tsx or twitter-image.tsx files
+ *
+ * WHY:
+ * Next.js uses internal `__metadata_id__` slug for these APIs. Exporting them from
+ * custom dynamic routes like `[id]` creates a slug naming conflict.
+ *
+ * Usage:
+ *   pnpm preflight:metadata-api-placement
+ */
+export declare const id = "nextjs/metadata-api-placement";
+export declare const name = "Metadata Api Placement";
+export declare const category = "nextjs";
+export declare const blocking = false;
+export declare const description = "Metadata API Placement Preflight - BLOCKING";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=metadata-api-placement.d.ts.map

package/dist/checks/nextjs/metadata-api-placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-api-placement.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/metadata-api-placement.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,gDAAgD,CAAC;AACzE,eAAO,MAAM,IAAI,UAAa,CAAC;AAuM/B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA4DzC"}