@veloxts/cli 0.4.12 → 0.4.13

package/dist/dev/error-parser.js

@@ -0,0 +1,384 @@
+/**
+ * Error Parser - Analyzes development errors and provides actionable feedback
+ *
+ * Parses error messages and stack traces to identify error types, extract
+ * file locations, and generate helpful suggestions for resolution.
+ *
+ * Inspired by Vite's error overlay and Next.js's error page patterns.
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseDevError(error);
+ *
+ * console.log(parsed.type);        // 'syntax-error'
+ * console.log(parsed.filePath);    // 'src/procedures/users.ts'
+ * console.log(parsed.line);        // 42
+ * console.log(parsed.suggestion);  // 'Check for missing closing bracket...'
+ * ```
+ */
+// ============================================================================
+// Error Detection Patterns
+// ============================================================================
+/**
+ * Patterns to identify error types from messages
+ */
+const ERROR_TYPE_PATTERNS = [
+    {
+        type: 'syntax-error',
+        patterns: [
+            /SyntaxError/i,
+            /Unexpected token/i,
+            /Missing semicolon/i,
+            /Unexpected end of input/i,
+            /Invalid or unexpected token/i,
+            /Unterminated string/i,
+            /Expression expected/i,
+            /Declaration or statement expected/i,
+        ],
+    },
+    {
+        type: 'module-not-found',
+        patterns: [
+            /Cannot find module/i,
+            /Module not found/i,
+            /ERR_MODULE_NOT_FOUND/i,
+            /Cannot resolve module/i,
+            /Unable to resolve/i,
+            /Could not resolve/i,
+        ],
+    },
+    {
+        type: 'type-error',
+        patterns: [
+            /TypeError/i,
+            /Type '.*' is not assignable/i,
+            /Property '.*' does not exist/i,
+            /Argument of type/i,
+            /Cannot read propert/i,
+            /is not a function/i,
+            /undefined is not/i,
+            /null is not/i,
+        ],
+    },
+    {
+        type: 'database-error',
+        patterns: [
+            /PrismaClient/i,
+            /P\d{4}:/i, // Prisma error codes like P1001
+            /Connection refused/i,
+            /ECONNREFUSED.*5432/i, // PostgreSQL
+            /ECONNREFUSED.*3306/i, // MySQL
+            /database.*does not exist/i,
+            /relation.*does not exist/i,
+        ],
+    },
+    {
+        type: 'port-in-use',
+        patterns: [/EADDRINUSE/i, /address already in use/i, /port.*already.*bound/i],
+    },
+    {
+        type: 'permission-denied',
+        patterns: [/EACCES/i, /EPERM/i, /permission denied/i, /access denied/i],
+    },
+    {
+        type: 'hmr-failure',
+        patterns: [
+            /hot-hook/i,
+            /HMR.*failed/i,
+            /Hot.*update.*failed/i,
+            /Cannot apply update/i,
+            /Module.*cannot be hot-updated/i,
+        ],
+    },
+];
+/**
+ * Patterns to extract file locations from error messages and stacks
+ */
+const LOCATION_PATTERNS = [
+    // TypeScript/esbuild: path/file.ts:10:5
+    { regex: /([^\s(]+\.(?:ts|tsx|js|jsx|mjs|cjs)):(\d+):(\d+)/, fileGroup: 1, lineGroup: 2, columnGroup: 3 },
+    // Node.js: at Function (path/file.ts:10:5)
+    { regex: /at\s+.*\(([^)]+):(\d+):(\d+)\)/, fileGroup: 1, lineGroup: 2, columnGroup: 3 },
+    // Node.js: at path/file.ts:10:5
+    { regex: /at\s+([^\s]+):(\d+):(\d+)/, fileGroup: 1, lineGroup: 2, columnGroup: 3 },
+    // ESLint/Prettier style: path/file.ts(10,5)
+    { regex: /([^\s(]+\.(?:ts|tsx|js|jsx))\((\d+),(\d+)\)/, fileGroup: 1, lineGroup: 2, columnGroup: 3 },
+    // Simple: path/file.ts:10
+    { regex: /([^\s:]+\.(?:ts|tsx|js|jsx|mjs|cjs)):(\d+)(?:\s|$|:)/, fileGroup: 1, lineGroup: 2 },
+];
+/**
+ * Suggestions mapped to error types
+ */
+const ERROR_SUGGESTIONS = {
+    'syntax-error': 'Check for missing brackets, parentheses, or semicolons. Ensure all strings and template literals are properly closed.',
+    'module-not-found': 'Verify the import path is correct. Check if the module is installed (run pnpm install) and the file extension matches your imports.',
+    'type-error': 'Check that all variables are properly typed and initialized. Verify the types match between function arguments and parameters.',
+    'runtime-error': 'Add console.log statements or use a debugger to trace the code path. Check for null/undefined values.',
+    'hmr-failure': 'This file may be outside HMR boundaries. Try editing a file in src/procedures/, src/schemas/, or src/handlers/ instead.',
+    'database-error': 'Ensure your database is running and accessible. Check DATABASE_URL in .env matches your database configuration. Run `velox migrate:status` to check migration status.',
+    'port-in-use': 'Another process is using this port. Stop other servers or use a different port with --port flag.',
+    'permission-denied': 'Check file permissions. You may need to run with elevated privileges or fix ownership of the files.',
+    unknown: 'Check the full error message and stack trace for clues. Consider searching for the error message online.',
+};
+/**
+ * Help URLs for common error types
+ */
+const ERROR_HELP_URLS = {
+    'database-error': 'https://www.prisma.io/docs/reference/api-reference/error-reference',
+    'module-not-found': 'https://nodejs.org/api/esm.html#resolution-algorithm',
+};
+// ============================================================================
+// Core Parser Functions
+// ============================================================================
+/**
+ * Parse a development error into structured, actionable information.
+ *
+ * @param error - The error to parse
+ * @returns Parsed error with type, location, and suggestions
+ */
+export function parseDevError(error) {
+    const errorText = formatErrorText(error);
+    const type = detectErrorType(errorText);
+    const location = extractLocation(errorText);
+    const message = cleanErrorMessage(error.message);
+    const suggestion = generateSuggestion(type, errorText);
+    const codeFrame = extractCodeFrame(errorText);
+    return {
+        originalError: error,
+        type,
+        message,
+        filePath: location?.filePath,
+        line: location?.line,
+        column: location?.column,
+        suggestion,
+        helpUrl: ERROR_HELP_URLS[type],
+        isRecoverable: isErrorRecoverable(type),
+        codeFrame,
+    };
+}
+/**
+ * Combine error message and stack for comprehensive analysis
+ */
+function formatErrorText(error) {
+    const parts = [error.message];
+    if (error.stack) {
+        parts.push(error.stack);
+    }
+    // Include cause if present (Error.cause in ES2022+)
+    // Use proper type narrowing instead of type assertion
+    if ('cause' in error && error.cause instanceof Error) {
+        parts.push(`Caused by: ${error.cause.message}`);
+        if (error.cause.stack) {
+            parts.push(error.cause.stack);
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Detect the error type from error text
+ */
+function detectErrorType(errorText) {
+    for (const { type, patterns } of ERROR_TYPE_PATTERNS) {
+        for (const pattern of patterns) {
+            if (pattern.test(errorText)) {
+                return type;
+            }
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Extract file location from error text
+ */
+function extractLocation(errorText) {
+    for (const pattern of LOCATION_PATTERNS) {
+        const match = pattern.regex.exec(errorText);
+        if (match) {
+            const filePath = match[pattern.fileGroup];
+            const line = parseInt(match[pattern.lineGroup], 10);
+            const column = pattern.columnGroup ? parseInt(match[pattern.columnGroup], 10) : undefined;
+            // Skip internal node_modules paths unless they're the only match
+            if (!filePath.includes('node_modules/') || !hasUserCodeLocation(errorText)) {
+                return { filePath, line, column };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if error text contains a user code location (not node_modules)
+ */
+function hasUserCodeLocation(errorText) {
+    for (const pattern of LOCATION_PATTERNS) {
+        const regex = new RegExp(pattern.regex.source, 'g');
+        let match;
+        while ((match = regex.exec(errorText)) !== null) {
+            const filePath = match[pattern.fileGroup];
+            if (!filePath.includes('node_modules/')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Clean up error message for display
+ */
+function cleanErrorMessage(message) {
+    // Remove ANSI color codes
+    let cleaned = message.replace(/\x1b\[[0-9;]*m/g, '');
+    // Remove excessive whitespace
+    cleaned = cleaned.replace(/\s+/g, ' ').trim();
+    // Truncate very long messages
+    const maxLength = 200;
+    if (cleaned.length > maxLength) {
+        cleaned = `${cleaned.slice(0, maxLength)}...`;
+    }
+    return cleaned;
+}
+/**
+ * Generate contextual suggestion based on error type and content
+ */
+function generateSuggestion(type, errorText) {
+    // Start with base suggestion for the error type
+    let suggestion = ERROR_SUGGESTIONS[type];
+    // Add contextual enhancements
+    if (type === 'module-not-found') {
+        // Extract module name for more specific advice
+        const moduleMatch = /Cannot find module ['"]([^'"]+)['"]/i.exec(errorText);
+        if (moduleMatch) {
+            const moduleName = moduleMatch[1];
+            if (moduleName.startsWith('.') || moduleName.startsWith('/')) {
+                suggestion = `Check that the file '${moduleName}' exists and the path is correct relative to the importing file.`;
+            }
+            else if (moduleName.startsWith('@')) {
+                suggestion = `Install the package: pnpm add ${moduleName}`;
+            }
+            else {
+                suggestion = `Install the package: pnpm add ${moduleName}`;
+            }
+        }
+    }
+    if (type === 'database-error') {
+        // Check for specific Prisma errors
+        if (/P1001/i.test(errorText)) {
+            suggestion = 'Cannot reach database server. Ensure your database is running and DATABASE_URL is correct.';
+        }
+        else if (/P1002/i.test(errorText)) {
+            suggestion = 'Database server timed out. Check if the database is overloaded or the connection is slow.';
+        }
+        else if (/P1003/i.test(errorText)) {
+            suggestion = 'Database does not exist. Run `velox migrate:run` to create and migrate the database.';
+        }
+        else if (/P2002/i.test(errorText)) {
+            suggestion = 'Unique constraint violation. A record with this value already exists.';
+        }
+        else if (/P2025/i.test(errorText)) {
+            suggestion = 'Record not found. The requested record does not exist in the database.';
+        }
+    }
+    if (type === 'syntax-error') {
+        // Check for common syntax issues
+        if (/Unexpected token.*export/i.test(errorText)) {
+            suggestion =
+                'Ensure you\'re using ES modules syntax. Check that "type": "module" is in your package.json.';
+        }
+        else if (/Unexpected token.*import/i.test(errorText)) {
+            suggestion =
+                'Check that your Node.js version supports ES modules (v14+) and "type": "module" is in package.json.';
+        }
+    }
+    return suggestion;
+}
+/**
+ * Extract code frame from error text if present
+ */
+function extractCodeFrame(errorText) {
+    // Look for code frame patterns (common in esbuild, TypeScript, etc.)
+    // Pattern: line numbers followed by code, with > marking error line
+    const frameMatch = /(?:^|\n)((?:\s*\d+\s*│[^\n]*\n)+)/m.exec(errorText);
+    if (frameMatch) {
+        return frameMatch[1].trim();
+    }
+    // Alternative pattern: > marking with pipe separators
+    const altFrameMatch = /(?:^|\n)((?:\s*>?\s*\d+\s*\|[^\n]*\n)+)/m.exec(errorText);
+    if (altFrameMatch) {
+        return altFrameMatch[1].trim();
+    }
+    return undefined;
+}
+/**
+ * Determine if error is recoverable by editing files
+ */
+function isErrorRecoverable(type) {
+    const recoverableTypes = [
+        'syntax-error',
+        'module-not-found',
+        'type-error',
+        'runtime-error',
+        'hmr-failure',
+    ];
+    return recoverableTypes.includes(type);
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if an error is a development-time error vs a fatal/configuration error
+ */
+export function isDevelopmentError(error) {
+    const parsed = parseDevError(error);
+    return parsed.isRecoverable;
+}
+/**
+ * Get a short, displayable error type label
+ */
+export function getErrorTypeLabel(type) {
+    const labels = {
+        'syntax-error': 'Syntax Error',
+        'module-not-found': 'Module Not Found',
+        'type-error': 'Type Error',
+        'runtime-error': 'Runtime Error',
+        'hmr-failure': 'HMR Failed',
+        'database-error': 'Database Error',
+        'port-in-use': 'Port In Use',
+        'permission-denied': 'Permission Denied',
+        unknown: 'Error',
+    };
+    return labels[type];
+}
+/**
+ * Format parsed error for console output
+ */
+export function formatParsedError(parsed) {
+    const parts = [];
+    // Error type and message
+    parts.push(`${getErrorTypeLabel(parsed.type)}: ${parsed.message}`);
+    // Location
+    if (parsed.filePath) {
+        let location = `  at ${parsed.filePath}`;
+        if (parsed.line) {
+            location += `:${parsed.line}`;
+            if (parsed.column) {
+                location += `:${parsed.column}`;
+            }
+        }
+        parts.push(location);
+    }
+    // Code frame
+    if (parsed.codeFrame) {
+        parts.push('');
+        parts.push(parsed.codeFrame);
+    }
+    // Suggestion
+    if (parsed.suggestion) {
+        parts.push('');
+        parts.push(`  Suggestion: ${parsed.suggestion}`);
+    }
+    // Help URL
+    if (parsed.helpUrl) {
+        parts.push(`  More info: ${parsed.helpUrl}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=error-parser.js.map

package/dist/dev/error-parser.js.map

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

package/dist/dev/hmr-runner.d.ts

@@ -1,8 +1,8 @@
 /**
- * HMR Runner - Experimental Hot Module Replacement
+ * HMR Runner - Hot Module Replacement for Development
  *
- * Uses hot-hook library to enable module replacement without full process restart.
- * This is marked as experimental and may not work for all use cases.
+ * Manages a Node.js process with hot-hook enabled for fast module replacement.
+ * Provides rich feedback with timing information and helpful error messages.
  *
  * @see https://github.com/Julien-R44/hot-hook
  */
@@ -18,32 +18,90 @@ export interface HMRRunnerOptions {
     readonly host: string;
     /** Environment variables to pass */
     readonly env?: Record<string, string>;
+    /** Show detailed timing and reload information */
+    readonly verbose?: boolean;
+    /** Enable debug logging and request tracing */
+    readonly debug?: boolean;
+    /** Clear console on full restart */
+    readonly clearOnRestart?: boolean;
 }
 /**
  * HMR Runner manages a Node.js process with hot-hook enabled
- * for experimental hot module replacement.
+ * for fast hot module replacement during development.
  */
 export declare class HMRRunner {
     private readonly options;
     private child;
     private isShuttingDown;
-    private restartCount;
+    private isStartingUp;
+    private startupTimer;
+    private readonly timing;
+    private readonly reporter;
     constructor(options: HMRRunnerOptions);
     /**
      * Start the HMR-enabled development server
      */
     start(): Promise<void>;
     /**
-     * Stop the HMR runner
+     * Stop the HMR runner gracefully
      */
     stop(): Promise<void>;
     /**
-     * Restart the process (used when HMR fails)
+     * Restart the process (called when HMR fails or non-boundary file changes)
+     */
+    private restart;
+    /**
+     * Spawn the Node.js process with hot-hook enabled
      */
-    restart(): Promise<void>;
-    private printHMRBanner;
     private spawnProcess;
+    /**
+     * Setup detection for when the server is ready
+     */
+    private setupStartupDetection;
+    /**
+     * Report that startup is complete
+     */
+    private reportStartupComplete;
+    /**
+     * Handle IPC messages from hot-hook
+     */
+    private handleIPCMessage;
+    /**
+     * Handle successful hot module update
+     */
+    private handleHotUpdate;
+    /**
+     * Handle request for full process reload
+     */
+    private handleFullReloadRequest;
+    /**
+     * Handle HMR-specific error
+     */
+    private handleHMRError;
+    /**
+     * Handle process spawn/runtime errors
+     */
+    private handleProcessError;
+    /**
+     * Handle process exit
+     */
+    private handleProcessExit;
+    /**
+     * Handle restart failure
+     */
+    private handleRestartError;
+    /**
+     * Report a fatal error that cannot be recovered
+     */
+    private reportFatalError;
+    /**
+     * Setup process signal handlers for graceful shutdown
+     */
     private setupSignalHandlers;
+    /**
+     * Get basename from file path
+     */
+    private getBasename;
 }
 /**
  * Run the development server with HMR enabled

package/dist/dev/hmr-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr-runner.d.ts","sourceRoot":"","sources":["../../src/dev/hmr-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,SAAS;IAKR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAK;gBAEI,OAAO,EAAE,gBAAgB;IAEtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,OAAO,CAAC,cAAc;YAYR,YAAY;IAyD1B,OAAO,CAAC,mBAAmB;CAW5B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E"}
+{"version":3,"file":"hmr-runner.d.ts","sourceRoot":"","sources":["../../src/dev/hmr-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4CH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAsDD;;;GAGG;AACH,qBAAa,SAAS;IAUR,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAA8C;IAGlE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAEb,OAAO,EAAE,gBAAgB;IAYtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC3B;;OAEG;YACW,OAAO;IAqBrB;;OAEG;YACW,YAAY;IA8B1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAIpB;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E"}