@empline/preflight 1.1.0

package/dist/checks/code-hygiene/any-type-detection.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * TypeScript 'any' Type Detection Preflight (BLOCKING)
+ *
+ * Detects usage of 'any' type which bypasses TypeScript's type safety.
+ *
+ * Patterns detected:
+ * - : any
+ * - as any
+ * - <any>
+ * - any[]
+ *
+ * Excludes:
+ * - Type definition files (.d.ts)
+ * - Test files
+ * - Third-party type augmentations
+ * - Legitimate uses with // @ts-expect-error or eslint-disable
+ *
+ * Usage:
+ *   pnpm preflight:any-type
+ *   pnpm preflight:any-type --warning
+ *   pnpm preflight:any-type --strict  (also flags 'unknown' casts)
+ */
+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;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const exclusions_1 = require("../../shared/exclusions");
+const glob_1 = require("glob");
+// Check metadata
+exports.id = "code-hygiene/any-type-detection";
+exports.name = "Any Type Detection";
+exports.category = "code-hygiene";
+exports.blocking = true;
+exports.description = "TypeScript 'any' Type Detection Preflight (BLOCKING)";
+exports.tags = ["code-hygiene"];
+let appExclusions = [];
+const CONFIG = {
+    includeDirs: ["app", "components", "lib", "hooks", "contexts"],
+    excludePatterns: [
+        "**/node_modules/**",
+        "**/.next/**",
+        "**/__mocks__/**",
+        "**/dist/**",
+        "**/coverage/**",
+    ],
+    // Files that legitimately need 'any' (third-party integrations, etc.)
+    allowedFiles: [
+        "lib/paypal", // PayPal SDK types are incomplete
+        "lib/stripe", // Stripe webhook types
+        "lib/analytics", // Analytics libraries
+        "middleware.ts", // Next.js middleware edge cases
+    ],
+};
+function shouldSkipFile(filePath) {
+    return (0, exclusions_1.shouldExcludeFile)(filePath, appExclusions);
+}
+// Patterns to detect 'any' usage
+const ANY_PATTERNS = [
+    { regex: /:\s*any\b(?!\w)/g, type: "type-annotation" },
+    { regex: /as\s+any\b(?!\w)/g, type: "type-cast" },
+    { regex: /<any\s*>/g, type: "generic" },
+    { regex: /:\s*any\[\]/g, type: "array" },
+    { regex: /:\s*Array<any>/g, type: "array" },
+];
+// Lines with these patterns are allowed
+const ALLOWED_LINE_PATTERNS = [
+    /\/\/\s*@ts-expect-error/,
+    /\/\/\s*@ts-ignore/,
+    /\/\/\s*eslint-disable/,
+    /\/\*\s*eslint-disable/,
+    /\/\/\s*TODO:/i, // Temporary any with TODO
+    /\/\/\s*FIXME:/i,
+];
+async function detectAnyType() {
+    const violations = [];
+    const patterns = CONFIG.includeDirs.map((dir) => `${dir}/**/*.{ts,tsx}`);
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: CONFIG.excludePatterns,
+            nodir: true,
+        });
+        files.push(...matches);
+    }
+    for (const file of files) {
+        const relativePath = file.replace(/\\/g, "/");
+        // Skip allowed files
+        if (CONFIG.allowedFiles.some((allowed) => relativePath.includes(allowed))) {
+            continue;
+        }
+        // Skip files based on app exclusions
+        if (shouldSkipFile(relativePath)) {
+            continue;
+        }
+        const content = fs.readFileSync(file, "utf-8");
+        const lines = content.split("\n");
+        lines.forEach((line, index) => {
+            // Skip if line has allowed pattern
+            if (ALLOWED_LINE_PATTERNS.some((p) => p.test(line))) {
+                return;
+            }
+            // Skip comments
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+                return;
+            }
+            // Check each pattern
+            for (const { regex, type } of ANY_PATTERNS) {
+                if (regex.test(line)) {
+                    violations.push({
+                        file: relativePath,
+                        line: index + 1,
+                        content: trimmed.substring(0, 70),
+                        pattern: type,
+                    });
+                    break; // Only report once per line
+                }
+            }
+        });
+    }
+    return violations;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const args = process.argv.slice(2);
+    const warningOnly = args.includes("--warning") || args.includes("--warn");
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "double"));
+    console.log("  'ANY' TYPE DETECTION" + (warningOnly ? " (warning mode)" : " (BLOCKING)"));
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const violations = await detectAnyType();
+    if (violations.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No 'any' type usage found in production code\n`);
+        process.exit(0);
+    }
+    // Group by pattern type
+    const byPattern = new Map();
+    for (const v of violations) {
+        if (!byPattern.has(v.pattern))
+            byPattern.set(v.pattern, []);
+        byPattern.get(v.pattern).push(v);
+    }
+    console.log(`\n${console_chars_1.emoji.error} Found ${violations.length} 'any' type usages:\n`);
+    for (const [pattern, items] of byPattern) {
+        const label = {
+            "type-annotation": ": any (type annotation)",
+            "type-cast": "as any (type cast)",
+            generic: "<any> (generic)",
+            array: "any[] (array)",
+        }[pattern] || pattern;
+        console.log(`\n${console_chars_1.emoji.memo} ${label} (${items.length}):`);
+        const toShow = verbose ? items : items.slice(0, 5);
+        for (const v of toShow) {
+            console.log(`   ${v.file}:${v.line}`);
+            console.log(`      ${v.content}`);
+        }
+        if (!verbose && items.length > 5) {
+            console.log(`   ... and ${items.length - 5} more`);
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "light"));
+    console.log(`${console_chars_1.emoji.hint} To fix:`);
+    console.log("   1. Use specific types: : string, : number, : MyInterface");
+    console.log("   2. Use unknown for truly unknown: : unknown (then narrow)");
+    console.log("   3. Use generics: <T>(value: T) => T");
+    console.log("   4. Create proper interfaces for complex objects");
+    console.log("   5. If unavoidable: add // @ts-expect-error with explanation");
+    console.log((0, console_chars_1.createDivider)(70, "light") + "\n");
+    if (warningOnly) {
+        console.log(`${console_chars_1.emoji.warning}  Warning mode - not blocking\n`);
+        process.exit(0);
+    }
+    process.exit(1);
+}
+main().catch(console.error);
+//# sourceMappingURL=any-type-detection.js.map

package/dist/checks/code-hygiene/any-type-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-type-detection.js","sourceRoot":"","sources":["../../../src/checks/code-hygiene/any-type-detection.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AAEzB,2CAA6B;AAC7B,6DAAiE;AACjE,uFAAwF;AACxF,wDAA2E;AAC3E,+BAA4B;AAG5B,iBAAiB;AACJ,QAAA,EAAE,GAAG,iCAAiC,CAAC;AACvC,QAAA,IAAI,GAAG,oBAAoB,CAAC;AAC5B,QAAA,QAAQ,GAAG,cAAc,CAAC;AAC1B,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,sDAAsD,CAAC;AACrE,QAAA,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;AASrC,IAAI,aAAa,GAAa,EAAE,CAAC;AAEjC,MAAM,MAAM,GAAG;IACb,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC;IAC9D,eAAe,EAAE;QACf,oBAAoB;QACpB,aAAa;QACb,iBAAiB;QACjB,YAAY;QACZ,gBAAgB;KACjB;IAED,sEAAsE;IACtE,YAAY,EAAE;QACZ,YAAY,EAAE,kCAAkC;QAChD,YAAY,EAAE,uBAAuB;QACrC,eAAe,EAAE,sBAAsB;QACvC,eAAe,EAAE,gCAAgC;KAClD;CACF,CAAC;AAEF,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,IAAA,8BAAiB,EAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,iCAAiC;AACjC,MAAM,YAAY,GAAG;IACnB,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAA0B,EAAE;IAC/D,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAoB,EAAE;IAC1D,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAkB,EAAE;IAChD,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,OAAgB,EAAE;IACjD,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAgB,EAAE;CACrD,CAAC;AAEF,wCAAwC;AACxC,MAAM,qBAAqB,GAAG;IAC5B,yBAAyB;IACzB,mBAAmB;IACnB,uBAAuB;IACvB,uBAAuB;IACvB,eAAe,EAAE,0BAA0B;IAC3C,gBAAgB;CACjB,CAAC;AAEF,KAAK,UAAU,aAAa;IAC1B,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAC;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE;YAClC,MAAM,EAAE,MAAM,CAAC,eAAe;YAC9B,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE9C,qBAAqB;QACrB,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC1E,SAAS;QACX,CAAC;QAED,qCAAqC;QACrC,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,mCAAmC;YACnC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,gBAAgB;YAChB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpF,OAAO;YACT,CAAC;YAED,qBAAqB;YACrB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,KAAK,GAAG,CAAC;wBACf,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;wBACjC,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;oBACH,MAAM,CAAC,4BAA4B;gBACrC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAElE,aAAa,GAAG,MAAM,IAAA,0BAAa,EAAC,UAAE,CAAC,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAA,6BAAa,EAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEzC,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,iDAAiD,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,UAAU,UAAU,CAAC,MAAM,uBAAuB,CAAC,CAAC;IAEhF,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACzC,MAAM,KAAK,GACT;YACE,iBAAiB,EAAE,yBAAyB;YAC5C,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,eAAe;SACvB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;QAExB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,IAAI,UAAU,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAE/C,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/checks/code-hygiene/api-error-handling.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * API Error Handling Preflight (BLOCKING)
+ *
+ * Ensures all API routes have proper error handling with try-catch.
+ * Unhandled errors in API routes cause 500 errors and poor UX.
+ *
+ * Checks:
+ * - All route handlers (GET, POST, PUT, DELETE, PATCH) have try-catch
+ * - Catch blocks return proper error responses
+ * - No bare throw statements without context
+ * - Safe JSON parsing (request.json() wrapped in try-catch)
+ * - Centralized logging (logger.error vs console.error)
+ *
+ * Consolidated from:
+ * - code-hygiene/api-error-handling.ts (primary)
+ * - observability/api-error-handling-validation.ts (merged)
+ *
+ * Usage:
+ *   pnpm preflight:api-error-handling
+ *   pnpm preflight:api-error-handling --warning
+ */
+export declare const id = "code-hygiene/api-error-handling";
+export declare const name = "Api Error Handling";
+export declare const category = "code-hygiene";
+export declare const blocking = true;
+export declare const description = "API Error Handling Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=api-error-handling.d.ts.map

package/dist/checks/code-hygiene/api-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error-handling.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/api-error-handling.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,eAAO,MAAM,EAAE,oCAAoC,CAAC;AACpD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAmB,CAAC"}

package/dist/checks/code-hygiene/api-error-handling.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * API Error Handling Preflight (BLOCKING)
+ *
+ * Ensures all API routes have proper error handling with try-catch.
+ * Unhandled errors in API routes cause 500 errors and poor UX.
+ *
+ * Checks:
+ * - All route handlers (GET, POST, PUT, DELETE, PATCH) have try-catch
+ * - Catch blocks return proper error responses
+ * - No bare throw statements without context
+ * - Safe JSON parsing (request.json() wrapped in try-catch)
+ * - Centralized logging (logger.error vs console.error)
+ *
+ * Consolidated from:
+ * - code-hygiene/api-error-handling.ts (primary)
+ * - observability/api-error-handling-validation.ts (merged)
+ *
+ * Usage:
+ *   pnpm preflight:api-error-handling
+ *   pnpm preflight:api-error-handling --warning
+ */
+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;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "code-hygiene/api-error-handling";
+exports.name = "Api Error Handling";
+exports.category = "code-hygiene";
+exports.blocking = true;
+exports.description = "API Error Handling Preflight (BLOCKING)";
+exports.tags = ["code-hygiene"];
+const HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+// Test/debug routes that are intentionally simple (skip validation)
+const TEST_ROUTE_PATTERNS = [
+    /api[\/\\]auth[\/\\]test[\/\\]/,
+    /api[\/\\]auth[\/\\]test-route[\/\\]/,
+    /api[\/\\]test-vercel[\/\\]/,
+    /api[\/\\]test-db[\/\\]/,
+    /api[\/\\]test-nextauth[\/\\]/,
+    /api[\/\\]debug/,
+    /api[\/\\]auth-debug[\/\\]/,
+];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedApiRouteFiles = null;
+async function getApiRouteFiles() {
+    if (!_cachedApiRouteFiles) {
+        _cachedApiRouteFiles = await file_cache_1.fileCache.getAPIRouteFiles();
+    }
+    return _cachedApiRouteFiles;
+}
+async function checkApiErrorHandling() {
+    const violations = [];
+    // Find all API route files
+    const files = await getApiRouteFiles();
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf-8");
+        const relativePath = file.replace(/\\/g, "/");
+        // Skip test/debug routes
+        if (TEST_ROUTE_PATTERNS.some((p) => p.test(relativePath))) {
+            continue;
+        }
+        // Check each HTTP method handler
+        for (const method of HTTP_METHODS) {
+            // Check for exported handler
+            const handlerPatterns = [
+                new RegExp(`export\\s+(async\\s+)?function\\s+${method}\\s*\\(`),
+                new RegExp(`export\\s+const\\s+${method}\\s*=`),
+            ];
+            const hasHandler = handlerPatterns.some((p) => p.test(content));
+            if (!hasHandler)
+                continue;
+            // Find the handler function start position
+            const functionStartMatch = content.match(new RegExp(`export\\s+(async\\s+)?function\\s+${method}\\s*\\([^)]*\\)\\s*\\{`)) ||
+                content.match(new RegExp(`export\\s+const\\s+${method}\\s*=\\s*(async\\s*)?\\([^)]*\\)\\s*=>\\s*\\{`)) ||
+                content.match(new RegExp(`export\\s+const\\s+${method}\\s*=\\s*(async\\s*)?function\\s*\\([^)]*\\)\\s*\\{`));
+            if (!functionStartMatch)
+                continue;
+            // Extract the function body by counting braces
+            const startIndex = content.indexOf(functionStartMatch[0]);
+            const bodyStartIndex = content.indexOf("{", startIndex);
+            let braceCount = 0;
+            let endIndex = bodyStartIndex;
+            for (let i = bodyStartIndex; i < content.length; i++) {
+                if (content[i] === "{")
+                    braceCount++;
+                if (content[i] === "}")
+                    braceCount--;
+                if (braceCount === 0) {
+                    endIndex = i + 1;
+                    break;
+                }
+            }
+            const handlerBody = content.slice(startIndex, endIndex);
+            // Check for try-catch or withErrorHandler wrapper
+            const hasTryCatch = /try\s*\{[\s\S]*?\}\s*catch/.test(handlerBody);
+            const hasWithErrorHandler = /return\s+withErrorHandler(?:<[^>]+>)?\s*\(/.test(handlerBody);
+            if (!hasTryCatch && !hasWithErrorHandler) {
+                // Check if it's a simple handler that might not need try-catch
+                const isSimple = handlerBody.split("\n").length < 10 &&
+                    !handlerBody.includes("await") &&
+                    !handlerBody.includes("prisma");
+                // Check if it's a dev/test route that returns early in production
+                const isDevOnly = /process\.env\.NODE_ENV\s*[!=]==?\s*['"](?:development|production)['"]/.test(handlerBody) || /process\.env\.VERCEL_ENV\s*===?\s*['"]production['"]/.test(handlerBody);
+                if (!isSimple && !isDevOnly) {
+                    violations.push({
+                        file: relativePath,
+                        handler: method,
+                        issue: "no-try-catch",
+                    });
+                }
+            }
+            else if (hasTryCatch) {
+                // Only check catch block quality for explicit try-catch (withErrorHandler handles this internally)
+                // Check for empty catch blocks
+                if (/catch\s*\([^)]*\)\s*\{\s*\}/.test(handlerBody)) {
+                    violations.push({
+                        file: relativePath,
+                        handler: method,
+                        issue: "empty-catch",
+                    });
+                }
+                // Check if catch returns proper error response
+                const catchMatch = handlerBody.match(/catch\s*\([^)]*\)\s*\{([^}]*)\}/);
+                if (catchMatch) {
+                    const catchBody = catchMatch[1];
+                    const hasErrorResponse = /NextResponse\.json\s*\([^)]*status:\s*[45]\d\d/.test(catchBody) ||
+                        /Response\.json\s*\([^)]*status:\s*[45]\d\d/.test(catchBody) ||
+                        /new\s+Response\s*\([^)]*status:\s*[45]\d\d/.test(catchBody) ||
+                        /return\s+.*error/i.test(catchBody);
+                    if (!hasErrorResponse && catchBody.trim().length > 0) {
+                        // Check if it re-throws or logs
+                        const rethrows = /throw\s/.test(catchBody);
+                        const logs = /console\.(error|log)/.test(catchBody);
+                        if (!rethrows && !logs) {
+                            violations.push({
+                                file: relativePath,
+                                handler: method,
+                                issue: "no-error-response",
+                            });
+                        }
+                    }
+                }
+            }
+            // Check for unsafe JSON parsing (from observability/api-error-handling-validation.ts)
+            // request.json() should be wrapped in try-catch to handle invalid JSON
+            if (/request\.json\(\)/.test(handlerBody)) {
+                const hasTryCatchWrapper = /try\s*\{[\s\S]*?\}\s*catch/.test(handlerBody);
+                const hasSafeJsonParse = /try\s*\{[^}]*request\.json\(\)[^}]*\}\s*catch/s.test(handlerBody);
+                if (!hasTryCatchWrapper && !hasSafeJsonParse) {
+                    violations.push({
+                        file: relativePath,
+                        handler: method,
+                        issue: "unsafe-json-parse",
+                    });
+                }
+            }
+            // Check for centralized logging (warn only)
+            // Prefer logger.error over console.error for observability
+            if (/console\.error/.test(handlerBody) && !/logger\.(error|warn)\s*\(/.test(handlerBody)) {
+                violations.push({
+                    file: relativePath,
+                    handler: method,
+                    issue: "no-centralized-logging",
+                });
+            }
+        }
+    }
+    return violations;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const args = process.argv.slice(2);
+    const warningOnly = args.includes("--warning") || args.includes("--warn");
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "double"));
+    console.log("  API ERROR HANDLING CHECK" + (warningOnly ? " (warning mode)" : " (BLOCKING)"));
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const violations = await checkApiErrorHandling();
+    // Count total API routes
+    const allRoutes = await getApiRouteFiles();
+    if (violations.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} All ${allRoutes.length} API routes have proper error handling\n`);
+        process.exit(0);
+    }
+    // Group by issue type
+    const byIssue = new Map();
+    for (const v of violations) {
+        if (!byIssue.has(v.issue))
+            byIssue.set(v.issue, []);
+        byIssue.get(v.issue).push(v);
+    }
+    console.log(`\n${console_chars_1.emoji.error} Found ${violations.length} API error handling issues:\n`);
+    const issueLabels = {
+        "no-try-catch": `${console_chars_1.emoji.bell} Missing try-catch (crashes on error)`,
+        "empty-catch": `${console_chars_1.emoji.warning}  Empty catch block (silent failure)`,
+        "no-error-response": `${console_chars_1.emoji.warning}  No error response in catch`,
+        "unsafe-json-parse": `${console_chars_1.emoji.warning}  Unsafe request.json() (crashes on invalid JSON)`,
+        "no-centralized-logging": `${console_chars_1.emoji.info}  Using console.error instead of logger`,
+    };
+    for (const [issue, items] of byIssue) {
+        console.log(`\n${issueLabels[issue]} (${items.length}):`);
+        const toShow = verbose ? items : items.slice(0, 5);
+        for (const v of toShow) {
+            console.log(`   ${v.file} ${console_chars_1.chars.arrow} ${v.handler}()`);
+        }
+        if (!verbose && items.length > 5) {
+            console.log(`   ... and ${items.length - 5} more`);
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "light"));
+    console.log(`${console_chars_1.emoji.hint} Proper API error handling pattern:`);
+    console.log("");
+    console.log("   export async function POST(request: Request) {");
+    console.log("     try {");
+    console.log("       let body;");
+    console.log("       try {");
+    console.log("         body = await request.json();");
+    console.log("       } catch {");
+    console.log('         return NextResponse.json({ error: "Invalid JSON" }, { status: 400 });');
+    console.log("       }");
+    console.log("       // ... your code");
+    console.log("       return NextResponse.json({ success: true });");
+    console.log("     } catch (error) {");
+    console.log('       logger.error("API Error:", { error, route: "/api/example" });');
+    console.log("       return NextResponse.json(");
+    console.log('         { error: "Internal server error" },');
+    console.log("         { status: 500 }");
+    console.log("       );");
+    console.log("     }");
+    console.log("   }");
+    console.log((0, console_chars_1.createDivider)(70, "light") + "\n");
+    if (warningOnly) {
+        console.log(`${console_chars_1.emoji.warning}  Warning mode - not blocking\n`);
+        process.exit(0);
+    }
+    // Only block on critical issues (no try-catch)
+    const critical = violations.filter((v) => v.issue === "no-try-catch");
+    if (critical.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ${critical.length} API routes missing try-catch - blocking\n`);
+        process.exit(1);
+    }
+    console.log(`${console_chars_1.emoji.info}  No critical issues - passing with warnings\n`);
+    process.exit(0);
+}
+main().catch(console.error);
+//# sourceMappingURL=api-error-handling.js.map

package/dist/checks/code-hygiene/api-error-handling.js.map

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

package/dist/checks/code-hygiene/broken-template-literals.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env tsx
+/**
+ * Broken Template Literals Preflight (BLOCKING)
+ *
+ * Detects template literal syntax inside regular strings, which means
+ * the variables never resolve:
+ *   "${emoji.error}"  - BROKEN (regular string)
+ *   `${emoji.error}`  - CORRECT (template literal)
+ *
+ * This is a targeted check for .mjs files where this pattern is common.
+ * TypeScript files rarely have this issue due to type checking.
+ *
+ * Usage:
+ *   pnpm preflight:broken-template-literals
+ *   pnpm preflight:broken-template-literals --warning
+ *   pnpm preflight:broken-template-literals --verbose
+ */
+export declare const id = "code-hygiene/broken-template-literals";
+export declare const name = "Broken Template Literals";
+export declare const category = "code-hygiene";
+export declare const blocking = true;
+export declare const description = "Broken Template Literals Preflight (BLOCKING)";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=broken-template-literals.d.ts.map

package/dist/checks/code-hygiene/broken-template-literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broken-template-literals.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/broken-template-literals.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAaH,eAAO,MAAM,EAAE,0CAA0C,CAAC;AAC1D,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,kDAAkD,CAAC;AAC3E,eAAO,MAAM,IAAI,UAAmB,CAAC;AA+GrC,wBAAsB,GAAG,kBAsExB"}