mastercontroller 1.2.12 → 1.2.14

package/error/MasterErrorMiddleware.js

@@ -0,0 +1,407 @@
+/**
+ * MasterErrorMiddleware - Request/Response error handling middleware
+ * Version: 1.0.1
+ */
+
+const { handleControllerError, handleRoutingError, sendErrorResponse } = require('./MasterBackendErrorHandler');
+const { logger } = require('./MasterErrorLogger');
+
+const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.master === 'development';
+
+/**
+ * Global error handler middleware
+ * Wrap all controller actions with this
+ */
+function errorHandlerMiddleware(handler, controllerName, actionName) {
+  return async function wrappedHandler(requestObject) {
+    const startTime = Date.now();
+
+    try {
+      // Execute the actual handler
+      const result = await Promise.resolve(handler.call(this, requestObject));
+
+      // Log successful request in development
+      if (isDevelopment) {
+        const duration = Date.now() - startTime;
+        logger.info({
+          code: 'MC_INFO_REQUEST_SUCCESS',
+          message: `${controllerName}#${actionName} completed`,
+          context: {
+            duration,
+            path: requestObject.pathName,
+            method: requestObject.type
+          }
+        });
+      }
+
+      return result;
+
+    } catch (error) {
+      const duration = Date.now() - startTime;
+
+      // Handle the error
+      const mcError = handleControllerError(
+        error,
+        controllerName,
+        actionName,
+        requestObject.pathName
+      );
+
+      // Send error response
+      sendErrorResponse(
+        requestObject.response,
+        mcError,
+        requestObject.pathName
+      );
+
+      // Log to monitoring
+      logger.error({
+        code: mcError.code,
+        message: mcError.message,
+        controller: controllerName,
+        action: actionName,
+        route: requestObject.pathName,
+        method: requestObject.type,
+        duration,
+        originalError: error,
+        stack: error.stack
+      });
+
+      // Don't re-throw - error has been handled
+      return null;
+    }
+  };
+}
+
+/**
+ * Request logging middleware
+ */
+function requestLoggerMiddleware() {
+  return function(requestObject, next) {
+    const startTime = Date.now();
+
+    logger.info({
+      code: 'MC_INFO_REQUEST_START',
+      message: `${requestObject.type} ${requestObject.pathName}`,
+      context: {
+        method: requestObject.type,
+        path: requestObject.pathName,
+        params: requestObject.params,
+        query: requestObject.query,
+        ip: requestObject.request.connection?.remoteAddress
+      }
+    });
+
+    // Continue to next middleware
+    if (typeof next === 'function') {
+      next();
+    }
+  };
+}
+
+/**
+ * 404 handler middleware
+ */
+function notFoundMiddleware(requestObject) {
+  const mcError = handleRoutingError(
+    requestObject.pathName,
+    [] // Would need to pass available routes here
+  );
+
+  sendErrorResponse(
+    requestObject.response,
+    mcError,
+    requestObject.pathName
+  );
+}
+
+/**
+ * Extract user code context from stack trace
+ */
+function extractUserCodeContext(stack) {
+  if (!stack) return null;
+
+  const lines = stack.split('\n');
+  const userFiles = [];
+  const frameworkFiles = [];
+
+  for (const line of lines) {
+    // Skip the error message line
+    if (!line.trim().startsWith('at ')) continue;
+
+    // Extract file path from stack line
+    const match = line.match(/\((.+?):(\d+):(\d+)\)|at (.+?):(\d+):(\d+)/);
+    if (!match) continue;
+
+    const filePath = match[1] || match[4];
+    const lineNum = match[2] || match[5];
+    const colNum = match[3] || match[6];
+
+    if (!filePath) continue;
+
+    // Categorize as user code or framework code
+    const isFramework = filePath.includes('node_modules/mastercontroller');
+    const isNodeInternal = filePath.includes('node:internal') || filePath.includes('/lib/internal/');
+
+    if (isNodeInternal) continue;
+
+    const fileInfo = {
+      file: filePath,
+      line: lineNum,
+      column: colNum,
+      location: `${filePath}:${lineNum}:${colNum}`
+    };
+
+    if (isFramework) {
+      frameworkFiles.push(fileInfo);
+    } else {
+      userFiles.push(fileInfo);
+    }
+  }
+
+  return {
+    userFiles,
+    frameworkFiles,
+    triggeringFile: userFiles[0] || frameworkFiles[0] || null
+  };
+}
+
+/**
+ * Uncaught exception handler
+ */
+function setupGlobalErrorHandlers() {
+  // Handle uncaught exceptions
+  process.on('uncaughtException', (error) => {
+    console.error('[MasterController] Uncaught Exception:', error);
+
+    // Extract context from stack trace
+    const context = extractUserCodeContext(error.stack);
+
+    // Build enhanced error message
+    let enhancedMessage = `Uncaught exception: ${error.message}`;
+
+    if (context && context.triggeringFile) {
+      enhancedMessage += `\n\n🔍 Error Location: ${context.triggeringFile.location}`;
+    }
+
+    if (context && context.userFiles.length > 0) {
+      enhancedMessage += `\n\n📂 Your Code Involved:`;
+      context.userFiles.forEach((file, i) => {
+        if (i < 3) { // Show first 3 user files
+          enhancedMessage += `\n   ${i + 1}. ${file.location}`;
+        }
+      });
+    }
+
+    if (context && context.frameworkFiles.length > 0) {
+      enhancedMessage += `\n\n🔧 Framework Files Involved:`;
+      context.frameworkFiles.forEach((file, i) => {
+        if (i < 2) { // Show first 2 framework files
+          enhancedMessage += `\n   ${i + 1}. ${file.location}`;
+        }
+      });
+    }
+
+    console.error(enhancedMessage);
+
+    logger.fatal({
+      code: 'MC_ERR_UNCAUGHT_EXCEPTION',
+      message: enhancedMessage,
+      originalError: error,
+      stack: error.stack,
+      context: context
+    });
+
+    // Give logger time to write, then exit
+    setTimeout(() => {
+      process.exit(1);
+    }, 1000);
+  });
+
+  // Handle unhandled promise rejections
+  process.on('unhandledRejection', (reason, promise) => {
+    console.error('[MasterController] Unhandled Rejection:', reason);
+
+    // Extract context from stack trace if available
+    const context = reason?.stack ? extractUserCodeContext(reason.stack) : null;
+
+    // Build enhanced error message
+    let enhancedMessage = `Unhandled promise rejection: ${reason}`;
+
+    if (context && context.triggeringFile) {
+      enhancedMessage += `\n\n🔍 Error Location: ${context.triggeringFile.location}`;
+    }
+
+    if (context && context.userFiles.length > 0) {
+      enhancedMessage += `\n\n📂 Your Code Involved:`;
+      context.userFiles.forEach((file, i) => {
+        if (i < 3) { // Show first 3 user files
+          enhancedMessage += `\n   ${i + 1}. ${file.location}`;
+        }
+      });
+    }
+
+    if (enhancedMessage !== `Unhandled promise rejection: ${reason}`) {
+      console.error(enhancedMessage);
+    }
+
+    logger.error({
+      code: 'MC_ERR_UNHANDLED_REJECTION',
+      message: enhancedMessage,
+      originalError: reason,
+      stack: reason?.stack,
+      context: context
+    });
+  });
+
+  // Handle warnings
+  process.on('warning', (warning) => {
+    if (isDevelopment) {
+      console.warn('[MasterController] Warning:', warning);
+    }
+
+    logger.warn({
+      code: 'MC_WARN_PROCESS_WARNING',
+      message: warning.message,
+      context: {
+        name: warning.name,
+        stack: warning.stack
+      }
+    });
+  });
+}
+
+/**
+ * Safe file reader with error handling
+ */
+function safeReadFile(fs, filePath, encoding = 'utf8') {
+  try {
+    return {
+      success: true,
+      content: fs.readFileSync(filePath, encoding),
+      error: null
+    };
+  } catch (error) {
+    const { handleFileReadError } = require('./MasterBackendErrorHandler');
+    const mcError = handleFileReadError(error, filePath);
+
+    return {
+      success: false,
+      content: null,
+      error: mcError
+    };
+  }
+}
+
+/**
+ * Safe file existence check
+ */
+function safeFileExists(fs, filePath) {
+  try {
+    return fs.existsSync(filePath);
+  } catch (error) {
+    logger.warn({
+      code: 'MC_WARN_FILE_CHECK',
+      message: `Could not check if file exists: ${filePath}`,
+      originalError: error
+    });
+    return false;
+  }
+}
+
+/**
+ * Wrap controller class with error handling
+ */
+function wrapController(ControllerClass, controllerName) {
+  const wrappedMethods = {};
+
+  // Get all methods from the controller
+  const methodNames = Object.getOwnPropertyNames(ControllerClass.prototype);
+
+  methodNames.forEach(methodName => {
+    if (methodName === 'constructor') return;
+
+    const originalMethod = ControllerClass.prototype[methodName];
+
+    if (typeof originalMethod === 'function') {
+      // Wrap each method with error handling
+      wrappedMethods[methodName] = errorHandlerMiddleware(
+        originalMethod,
+        controllerName,
+        methodName
+      );
+    }
+  });
+
+  // Create new class with wrapped methods
+  const WrappedController = class extends ControllerClass {
+    constructor(...args) {
+      super(...args);
+
+      // Apply wrapped methods
+      Object.keys(wrappedMethods).forEach(methodName => {
+        this[methodName] = wrappedMethods[methodName].bind(this);
+      });
+    }
+  };
+
+  return WrappedController;
+}
+
+/**
+ * Performance tracking middleware
+ */
+function performanceMiddleware() {
+  const requests = new Map();
+
+  return {
+    start(requestId, requestObject) {
+      requests.set(requestId, {
+        startTime: Date.now(),
+        path: requestObject.pathName,
+        method: requestObject.type
+      });
+    },
+
+    end(requestId) {
+      const req = requests.get(requestId);
+      if (!req) return;
+
+      const duration = Date.now() - req.startTime;
+
+      if (duration > 1000) {
+        logger.warn({
+          code: 'MC_WARN_SLOW_REQUEST',
+          message: `Slow request detected (${duration}ms)`,
+          context: {
+            duration,
+            path: req.path,
+            method: req.method
+          }
+        });
+      }
+
+      requests.delete(requestId);
+    },
+
+    getStats() {
+      return {
+        activeRequests: requests.size,
+        requests: Array.from(requests.values())
+      };
+    }
+  };
+}
+
+const performanceTracker = performanceMiddleware();
+
+module.exports = {
+  errorHandlerMiddleware,
+  requestLoggerMiddleware,
+  notFoundMiddleware,
+  setupGlobalErrorHandlers,
+  safeReadFile,
+  safeFileExists,
+  wrapController,
+  performanceTracker
+};

package/error/SSRErrorHandler.js

@@ -0,0 +1,273 @@
+/**
+ * SSRErrorHandler - Server-side rendering error handling
+ * Handles component render failures with graceful fallbacks
+ * Version: 1.0.1
+ */
+
+const { MasterControllerError } = require('./MasterErrorHandler');
+
+const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.master === 'development';
+
+/**
+ * Render error component for development mode
+ */
+function renderErrorComponent(options = {}) {
+  const {
+    component,
+    error,
+    stack,
+    file,
+    line,
+    details
+  } = options;
+
+  const errorObj = new MasterControllerError({
+    code: 'MC_ERR_COMPONENT_RENDER_FAILED',
+    message: error || 'Component failed to render on server',
+    component,
+    file,
+    line,
+    details: details || stack,
+    originalError: options.originalError
+  });
+
+  // Return full HTML error page in development
+  return errorObj.toHTML();
+}
+
+/**
+ * Render fallback component for production mode
+ */
+function renderFallback(componentName, options = {}) {
+  const { showSkeleton = true, customMessage } = options;
+
+  if (showSkeleton) {
+    return `
+      <div class="mc-fallback" data-component="${componentName}" style="
+        padding: 20px;
+        background: #f9fafb;
+        border-radius: 8px;
+        border: 1px dashed #d1d5db;
+        min-height: 100px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        color: #6b7280;
+      ">
+        <div class="mc-fallback-content">
+          ${customMessage || ''}
+          <div class="skeleton-loader" style="
+            width: 100%;
+            height: 20px;
+            background: linear-gradient(90deg, #e5e7eb 25%, #f3f4f6 50%, #e5e7eb 75%);
+            background-size: 200% 100%;
+            animation: skeleton-loading 1.5s ease-in-out infinite;
+            border-radius: 4px;
+          "></div>
+        </div>
+        <style>
+          @keyframes skeleton-loading {
+            0% { background-position: 200% 0; }
+            100% { background-position: -200% 0; }
+          }
+        </style>
+      </div>
+    `;
+  }
+
+  // Minimal fallback - just an empty div
+  return `<div class="mc-fallback" data-component="${componentName}"></div>`;
+}
+
+/**
+ * Safe component render wrapper
+ * Catches errors and returns either error page (dev) or fallback (prod)
+ */
+function safeRenderComponent(component, componentName, filePath) {
+  try {
+    // Try tempRender first
+    if (typeof component.tempRender === 'function') {
+      const startTime = Date.now();
+      const result = component.tempRender();
+      const renderTime = Date.now() - startTime;
+
+      // Warn about slow renders in development
+      if (isDevelopment && renderTime > 100) {
+        console.warn(
+          new MasterControllerError({
+            code: 'MC_ERR_SLOW_RENDER',
+            message: `Component rendering slowly on server (${renderTime}ms)`,
+            component: componentName,
+            file: filePath,
+            details: `Render time exceeded 100ms threshold. Consider optimizing this component.`
+          }).format()
+        );
+      }
+
+      return { success: true, html: result, renderTime };
+    }
+
+    // Fallback to connectedCallback
+    if (typeof component.connectedCallback === 'function') {
+      const startTime = Date.now();
+      component.connectedCallback();
+      const renderTime = Date.now() - startTime;
+
+      // Get the rendered HTML
+      const html = component.innerHTML || '';
+      return { success: true, html, renderTime };
+    }
+
+    // No render method found
+    throw new Error('No tempRender() or connectedCallback() method found');
+
+  } catch (error) {
+    console.error(
+      new MasterControllerError({
+        code: 'MC_ERR_COMPONENT_RENDER_FAILED',
+        message: `Failed to render component: ${error.message}`,
+        component: componentName,
+        file: filePath,
+        originalError: error
+      }).format()
+    );
+
+    if (isDevelopment) {
+      return {
+        success: false,
+        html: renderErrorComponent({
+          component: componentName,
+          error: error.message,
+          stack: error.stack,
+          file: filePath,
+          originalError: error
+        }),
+        renderTime: 0
+      };
+    } else {
+      // Log error for monitoring
+      logProductionError(error, componentName, filePath);
+
+      return {
+        success: false,
+        html: renderFallback(componentName, { showSkeleton: true }),
+        renderTime: 0
+      };
+    }
+  }
+}
+
+/**
+ * Log production errors for monitoring
+ */
+function logProductionError(error, component, file) {
+  const errorData = {
+    timestamp: new Date().toISOString(),
+    component,
+    file,
+    message: error.message,
+    stack: error.stack,
+    environment: 'production'
+  };
+
+  // Log to console (can be captured by monitoring services)
+  console.error('[MasterController Production Error]', JSON.stringify(errorData, null, 2));
+
+  // Hook for external logging services (Sentry, LogRocket, etc.)
+  if (global.masterControllerErrorHook) {
+    try {
+      global.masterControllerErrorHook(errorData);
+    } catch (hookError) {
+      console.error('[MasterController] Error hook failed:', hookError.message);
+    }
+  }
+}
+
+/**
+ * Wrap connectedCallback with try-catch
+ */
+function wrapConnectedCallback(element, componentName, filePath) {
+  if (!element || typeof element.connectedCallback !== 'function') {
+    return;
+  }
+
+  const originalCallback = element.connectedCallback;
+
+  element.connectedCallback = function(...args) {
+    try {
+      return originalCallback.apply(this, args);
+    } catch (error) {
+      console.error(
+        new MasterControllerError({
+          code: 'MC_ERR_COMPONENT_RENDER_FAILED',
+          message: `connectedCallback failed: ${error.message}`,
+          component: componentName,
+          file: filePath,
+          originalError: error
+        }).format()
+      );
+
+      if (isDevelopment) {
+        this.innerHTML = renderErrorComponent({
+          component: componentName,
+          error: error.message,
+          stack: error.stack,
+          file: filePath,
+          originalError: error
+        });
+      } else {
+        logProductionError(error, componentName, filePath);
+        this.innerHTML = renderFallback(componentName);
+      }
+    }
+  };
+}
+
+/**
+ * Check if component has required SSR methods
+ */
+function validateSSRComponent(componentClass, componentName, filePath) {
+  const warnings = [];
+
+  // Check for tempRender method
+  if (!componentClass.prototype.tempRender && !componentClass.prototype.connectedCallback) {
+    warnings.push(
+      new MasterControllerError({
+        code: 'MC_ERR_TEMPRENDER_MISSING',
+        message: 'Component missing tempRender() method for SSR',
+        component: componentName,
+        file: filePath,
+        details: `Add a tempRender() method to enable server-side rendering:\n\n  tempRender() {\n    return \`<div>Your HTML here</div>\`;\n  }`
+      })
+    );
+  }
+
+  // Warn if only render() exists (client-only)
+  if (componentClass.prototype.render && !componentClass.prototype.tempRender) {
+    warnings.push(
+      new MasterControllerError({
+        code: 'MC_ERR_TEMPRENDER_MISSING',
+        message: 'Component has render() but no tempRender() - will not SSR',
+        component: componentName,
+        file: filePath,
+        details: 'For SSR, rename render() to tempRender() or add a separate tempRender() method'
+      })
+    );
+  }
+
+  if (warnings.length > 0 && isDevelopment) {
+    warnings.forEach(warning => console.warn(warning.format()));
+  }
+
+  return warnings.length === 0;
+}
+
+module.exports = {
+  renderErrorComponent,
+  renderFallback,
+  safeRenderComponent,
+  wrapConnectedCallback,
+  validateSSRComponent,
+  logProductionError,
+  isDevelopment
+};