@empline/preflight 1.1.11 → 1.1.13

package/dist/checks/consolidated/import-cycles.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Import Cycle Detection Preflight
+ *
+ * Circular imports cause:
+ * - Runtime initialization errors
+ * - Undefined module exports
+ * - Hard-to-debug issues that only appear in production
+ *
+ * This check detects circular import chains and flags them as BLOCKING.
+ *
+ * Usage:
+ *   pnpm preflight:import-cycles              # Full check
+ *   pnpm preflight:import-cycles --verbose    # Show all detected cycles
+ *   pnpm preflight:import-cycles --max 3      # Limit chain depth
+ *
+ * @blocking 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.ImportCycleDetector = 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 glob_patterns_1 = require("../../shared/glob-patterns");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const concurrency_config_1 = require("../../shared/concurrency-config");
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.PRODUCTION_CODE_EXCLUDES, ["**/*.d.ts"]);
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAppComponentsHooksLibContextsAllFiles = null;
+async function getAppComponentsHooksLibContextsAllFiles() {
+    if (!_cachedAppComponentsHooksLibContextsAllFiles) {
+        _cachedAppComponentsHooksLibContextsAllFiles =
+            await file_cache_1.fileCache.getAppComponentsHooksLibContextsAllFiles();
+    }
+    return _cachedAppComponentsHooksLibContextsAllFiles;
+}
+// Get concurrency from shared config (respects PREFLIGHT_CONCURRENCY env var)
+const concurrencyConfig = (0, concurrency_config_1.getConcurrencyConfig)();
+class ImportCycleDetector {
+    verbose;
+    parallel = false;
+    maxDepth;
+    importGraph = new Map();
+    fileContents = new Map();
+    constructor(options = {}) {
+        this.verbose = options.verbose || false;
+        this.parallel = options.parallel ?? concurrencyConfig.parallel;
+        this.maxDepth = options.maxDepth || 10;
+    }
+    /**
+     * Extract imports from a TypeScript/JavaScript file
+     */
+    extractImports(filePath, content) {
+        const imports = [];
+        const lines = content.split("\n");
+        const dir = path.dirname(filePath);
+        lines.forEach((line, index) => {
+            // Skip comments
+            if (line.trim().startsWith("//") || line.trim().startsWith("*"))
+                return;
+            // Match various import patterns
+            const patterns = [
+                // import X from './path'
+                /import\s+.*\s+from\s+['"]([^'"]+)['"]/,
+                // import './path'
+                /import\s+['"]([^'"]+)['"]/,
+                // require('./path')
+                /require\s*\(\s*['"]([^'"]+)['"]\s*\)/,
+                // dynamic import('./path')
+                /import\s*\(\s*['"]([^'"]+)['"]\s*\)/,
+            ];
+            for (const pattern of patterns) {
+                const match = line.match(pattern);
+                if (match) {
+                    const importPath = match[1];
+                    // Only check relative imports (these can form cycles)
+                    if (importPath.startsWith(".")) {
+                        const resolvedPath = this.resolveImportPath(dir, importPath);
+                        if (resolvedPath) {
+                            imports.push({
+                                source: filePath,
+                                target: resolvedPath,
+                                line: index + 1,
+                            });
+                        }
+                    }
+                }
+            }
+        });
+        return imports;
+    }
+    /**
+     * Resolve import path to actual file
+     */
+    resolveImportPath(fromDir, importPath) {
+        const basePath = path.resolve(fromDir, importPath);
+        // Try various extensions
+        const extensions = [".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js"];
+        for (const ext of extensions) {
+            const fullPath = basePath + ext;
+            if (fs.existsSync(fullPath)) {
+                return path.normalize(fullPath);
+            }
+        }
+        // Check if path already has extension
+        if (fs.existsSync(basePath)) {
+            return path.normalize(basePath);
+        }
+        return null;
+    }
+    /**
+     * Build import graph from all files
+     */
+    async buildImportGraph() {
+        const files = await getAppComponentsHooksLibContextsAllFiles();
+        let totalImports = 0;
+        for (const file of files) {
+            const absolutePath = path.resolve(file);
+            const content = fs.readFileSync(file, "utf8");
+            this.fileContents.set(absolutePath, content);
+            const imports = this.extractImports(absolutePath, content);
+            if (!this.importGraph.has(absolutePath)) {
+                this.importGraph.set(absolutePath, new Set());
+            }
+            for (const imp of imports) {
+                this.importGraph.get(absolutePath).add(imp.target);
+                totalImports++;
+            }
+        }
+        return totalImports;
+    }
+    /**
+     * Detect cycles using DFS
+     */
+    detectCycles() {
+        const cycles = [];
+        const visited = new Set();
+        const recursionStack = new Set();
+        const pathStack = [];
+        const dfs = (file) => {
+            if (recursionStack.has(file)) {
+                // Found a cycle
+                const cycleStart = pathStack.indexOf(file);
+                if (cycleStart !== -1) {
+                    const cycle = pathStack.slice(cycleStart);
+                    cycle.push(file); // Complete the cycle
+                    cycles.push({
+                        files: cycle.map((f) => path.relative(process.cwd(), f)),
+                        depth: cycle.length,
+                    });
+                }
+                return;
+            }
+            if (visited.has(file))
+                return;
+            if (pathStack.length >= this.maxDepth)
+                return;
+            visited.add(file);
+            recursionStack.add(file);
+            pathStack.push(file);
+            const imports = this.importGraph.get(file);
+            if (imports) {
+                for (const importedFile of imports) {
+                    dfs(importedFile);
+                }
+            }
+            pathStack.pop();
+            recursionStack.delete(file);
+        };
+        for (const file of this.importGraph.keys()) {
+            visited.clear();
+            recursionStack.clear();
+            pathStack.length = 0;
+            dfs(file);
+        }
+        // Deduplicate cycles (same cycle can be detected from different starting points)
+        const uniqueCycles = new Map();
+        for (const cycle of cycles) {
+            const key = [...cycle.files].sort().join("|");
+            if (!uniqueCycles.has(key) || cycle.depth < uniqueCycles.get(key).depth) {
+                uniqueCycles.set(key, cycle);
+            }
+        }
+        return Array.from(uniqueCycles.values());
+    }
+    /**
+     * Run the import cycle detection
+     */
+    async run() {
+        const startTime = Date.now();
+        console.log(`\n${console_chars_1.emoji.refresh} IMPORT CYCLE DETECTION`);
+        console.log((0, console_chars_1.createDivider)(80, "heavy"));
+        const totalImports = await this.buildImportGraph();
+        const cycles = this.detectCycles();
+        const duration = Date.now() - startTime;
+        const passed = cycles.length === 0;
+        // Print results
+        console.log(`\nScanned: ${this.importGraph.size} files, ${totalImports} imports`);
+        console.log(`Found: ${cycles.length} circular import chains`);
+        console.log(`Time: ${(duration / 1000).toFixed(1)}s`);
+        if (cycles.length > 0) {
+            console.log(`\n${console_chars_1.emoji.error} CIRCULAR IMPORTS DETECTED:\n`);
+            const showCycles = this.verbose ? cycles : cycles.slice(0, 5);
+            showCycles.forEach((cycle, index) => {
+                console.log(`Cycle ${index + 1} (depth: ${cycle.depth}):`);
+                cycle.files.forEach((file, i) => {
+                    const arrow = i < cycle.files.length - 1 ? "  ${chars.arrowDown}" : "  ↺";
+                    console.log(`  ${file}${arrow}`);
+                });
+                console.log();
+            });
+            if (!this.verbose && cycles.length > 5) {
+                console.log(`... and ${cycles.length - 5} more cycles (use --verbose to see all)\n`);
+            }
+            console.log(`${console_chars_1.emoji.hint} To fix circular imports:`);
+            console.log("   1. Extract shared types/interfaces to a separate file");
+            console.log("   2. Use dependency injection");
+            console.log("   3. Restructure the module hierarchy");
+            console.log("   4. Consider lazy loading with dynamic imports\n");
+        }
+        console.log((0, console_chars_1.createDivider)(80, "heavy"));
+        if (passed) {
+            console.log(`${console_chars_1.emoji.success} NO CIRCULAR IMPORTS DETECTED\n`);
+        }
+        else {
+            console.log(`${console_chars_1.emoji.error} IMPORT CYCLE CHECK FAILED\n`);
+        }
+        return {
+            passed,
+            cycles,
+            duration,
+            totalFiles: this.importGraph.size,
+            totalImports,
+        };
+    }
+}
+exports.ImportCycleDetector = ImportCycleDetector;
+// CLI
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const parallel = args.includes("--parallel") || args.includes("-p");
+    let maxDepth = 10;
+    const maxIndex = args.indexOf("--max");
+    if (maxIndex !== -1 && args[maxIndex + 1]) {
+        maxDepth = parseInt(args[maxIndex + 1], 10);
+    }
+    const detector = new ImportCycleDetector({ verbose, maxDepth });
+    const result = await detector.run();
+    process.exit(result.passed ? 0 : 1);
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=import-cycles.js.map

package/dist/checks/consolidated/import-cycles.js.map

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

package/dist/checks/consolidated/imports.d.ts

@@ -0,0 +1,112 @@
+#!/usr/bin/env tsx
+/**
+ * Consolidated Import Validation Preflight
+ *
+ * Combines 7 separate import checks into one comprehensive module:
+ * - import-validation (correct import sources)
+ * - import-organization (import order)
+ * - import-source-consistency (@/components/ui vs @supercatch/ui)
+ * - server-only-imports (Prisma/server code in client components) [BLOCKING]
+ * - unused-imports (dead imports)
+ * - missing-imports (undefined references)
+ * - hook-import-validation (custom hooks)
+ *
+ * Usage:
+ *   pnpm preflight:imports              # All import checks
+ *   pnpm preflight:imports validation   # Source validation only
+ *   pnpm preflight:imports organization # Import order only
+ *   pnpm preflight:imports consistency  # @/components/ui consistency
+ *   pnpm preflight:imports server-only  # Server-only imports in client components
+ *   pnpm preflight:imports unused       # Unused imports only
+ *   pnpm preflight:imports missing      # Missing imports only
+ *   pnpm preflight:imports hooks        # Hook imports only
+ */
+interface Issue {
+    file: string;
+    line: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion?: string;
+    snippet?: string;
+}
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    blocking: boolean;
+    issues: Issue[];
+    duration: number;
+}
+interface ModuleResult {
+    module: string;
+    passed: boolean;
+    totalDuration: number;
+    checks: CheckResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        errors: number;
+        warnings: number;
+    };
+}
+declare class ImportsPreflightModule {
+    private verbose;
+    private parallel;
+    constructor(options?: {
+        verbose?: boolean;
+        parallel?: boolean;
+    });
+    private getFiles;
+    /**
+     * Import Source Validation
+     */
+    checkImportValidation(): Promise<CheckResult>;
+    /**
+     * Import Source Consistency (@/components/ui vs @supercatch/ui)
+     */
+    checkImportConsistency(): Promise<CheckResult>;
+    /**
+     * Import Organization (order)
+     */
+    checkImportOrganization(): Promise<CheckResult>;
+    private extractImportsWithCategory;
+    /**
+     * Unused Imports Detection
+     *
+     * Detects imports that are never used in the code.
+     * Handles edge cases:
+     * - Namespace access (MetadataRoute.Robots)
+     * - Type annotations in interfaces (children: ReactNode)
+     * - Type annotations in variable declarations (const x: Type)
+     * - Type parameters in generics (<T extends Type>)
+     */
+    checkUnusedImports(): Promise<CheckResult>;
+    /**
+     * Find where the import block ends (first non-import, non-empty, non-comment line)
+     */
+    private findImportBlockEnd;
+    private extractNamedImports;
+    /**
+     * Server-Only Imports in Client Components
+     * Detects when client components import server-only modules like Prisma
+     */
+    checkServerOnlyImports(): Promise<CheckResult>;
+    /**
+     * Missing Hook Imports
+     */
+    checkMissingHookImports(): Promise<CheckResult>;
+    private extractAllImportedNames;
+    private extractLocalHooks;
+    private removeComments;
+    /**
+     * Run all import checks
+     */
+    runAll(): Promise<ModuleResult>;
+    private printResults;
+}
+export { ImportsPreflightModule };
+//# sourceMappingURL=imports.d.ts.map

package/dist/checks/consolidated/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/checks/consolidated/imports.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgBH,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AA2ID,cAAM,sBAAsB;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;YAKrD,QAAQ;IAItB;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC;IA4EnD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC;IA+HpD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IAqCrD,OAAO,CAAC,0BAA0B;IA0DlC;;;;;;;;;OASG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAoDhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiD1B,OAAO,CAAC,mBAAmB;IAyD3B;;;OAGG;IACG,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC;IA6FpD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IAmDrD,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAmDrC,OAAO,CAAC,YAAY;CA+ErB;AA8GD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}