mastercontroller 1.3.9 → 1.3.12

package/error/HydrationMismatch.js

@@ -1,265 +0,0 @@
-/**
- * HydrationMismatch - Detect and report hydration mismatches
- * Compares server-rendered HTML with client-rendered HTML
- * Version: 1.0.0
- */
-
-const isDevelopment = typeof process !== 'undefined'
-  ? (process.env.NODE_ENV !== 'production')
-  : (window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1');
-
-/**
- * Simple diff algorithm for HTML comparison
- */
-function generateDiff(serverHTML, clientHTML) {
-  const serverLines = serverHTML.split('\n').map(l => l.trim()).filter(Boolean);
-  const clientLines = clientHTML.split('\n').map(l => l.trim()).filter(Boolean);
-
-  const diff = [];
-  const maxLines = Math.max(serverLines.length, clientLines.length);
-
-  for (let i = 0; i < maxLines; i++) {
-    const serverLine = serverLines[i] || '';
-    const clientLine = clientLines[i] || '';
-
-    if (serverLine !== clientLine) {
-      diff.push({
-        line: i + 1,
-        server: serverLine,
-        client: clientLine,
-        type: !serverLine ? 'added' : !clientLine ? 'removed' : 'modified'
-      });
-    }
-  }
-
-  return diff;
-}
-
-/**
- * Format diff for console output
- */
-function formatDiffForConsole(diff) {
-  let output = '\n';
-
-  diff.slice(0, 10).forEach(change => { // Show first 10 differences
-    output += `Line ${change.line}:\n`;
-
-    if (change.type === 'removed') {
-      output += `  \x1b[31m- ${change.server}\x1b[0m\n`;
-    } else if (change.type === 'added') {
-      output += `  \x1b[32m+ ${change.client}\x1b[0m\n`;
-    } else {
-      output += `  \x1b[31m- ${change.server}\x1b[0m\n`;
-      output += `  \x1b[32m+ ${change.client}\x1b[0m\n`;
-    }
-  });
-
-  if (diff.length > 10) {
-    output += `\n... and ${diff.length - 10} more differences\n`;
-  }
-
-  return output;
-}
-
-/**
- * Compare attributes between two elements
- */
-function compareAttributes(serverEl, clientEl) {
-  const mismatches = [];
-
-  // Check server attributes
-  if (serverEl.attributes) {
-    for (const attr of serverEl.attributes) {
-      const serverValue = attr.value;
-      const clientValue = clientEl.getAttribute(attr.name);
-
-      if (serverValue !== clientValue) {
-        mismatches.push({
-          attribute: attr.name,
-          server: serverValue,
-          client: clientValue || '(missing)'
-        });
-      }
-    }
-  }
-
-  // Check for client attributes missing on server
-  if (clientEl.attributes) {
-    for (const attr of clientEl.attributes) {
-      if (!serverEl.hasAttribute(attr.name)) {
-        mismatches.push({
-          attribute: attr.name,
-          server: '(missing)',
-          client: attr.value
-        });
-      }
-    }
-  }
-
-  return mismatches;
-}
-
-/**
- * Detect hydration mismatch between server and client HTML
- */
-function detectHydrationMismatch(element, componentName, options = {}) {
-  if (!element || !element.hasAttribute('data-ssr')) {
-    return null; // Not server-rendered
-  }
-
-  // Store server HTML before hydration
-  const serverHTML = element.innerHTML;
-
-  // Create a clone to test client rendering
-  const testElement = element.cloneNode(false);
-  testElement.removeAttribute('data-ssr');
-
-  // Simulate client render
-  if (typeof element.connectedCallback === 'function') {
-    try {
-      // Call connectedCallback to trigger client render
-      const originalCallback = element.constructor.prototype.connectedCallback;
-      if (originalCallback) {
-        originalCallback.call(testElement);
-      }
-    } catch (error) {
-      console.warn('[HydrationMismatch] Could not simulate client render:', error);
-      return null;
-    }
-  }
-
-  const clientHTML = testElement.innerHTML;
-
-  // Compare HTML
-  if (serverHTML.trim() === clientHTML.trim()) {
-    return null; // No mismatch
-  }
-
-  // Generate diff
-  const diff = generateDiff(serverHTML, clientHTML);
-
-  // Compare attributes
-  const attrMismatches = compareAttributes(element, testElement);
-
-  return {
-    component: componentName || element.tagName.toLowerCase(),
-    serverHTML,
-    clientHTML,
-    diff,
-    attrMismatches,
-    element
-  };
-}
-
-/**
- * Report hydration mismatch to console
- */
-function reportHydrationMismatch(mismatch, options = {}) {
-  if (!mismatch) return;
-
-  const { component, diff, attrMismatches } = mismatch;
-
-  console.group('\x1b[33m⚠️ MasterController Hydration Mismatch\x1b[0m');
-  console.log(`\x1b[36mComponent:\x1b[0m ${component}`);
-
-  // Attribute mismatches
-  if (attrMismatches.length > 0) {
-    console.log('\n\x1b[33mAttribute Mismatches:\x1b[0m');
-    attrMismatches.forEach(attr => {
-      console.log(`  ${attr.attribute}:`);
-      console.log(`    \x1b[31mServer: ${attr.server}\x1b[0m`);
-      console.log(`    \x1b[32mClient: ${attr.client}\x1b[0m`);
-    });
-  }
-
-  // HTML content mismatches
-  if (diff.length > 0) {
-    console.log('\n\x1b[33mHTML Diff:\x1b[0m');
-    console.log(formatDiffForConsole(diff));
-  }
-
-  // Suggestions
-  console.log('\n\x1b[36mPossible Causes:\x1b[0m');
-  console.log('  1. Component state differs between server and client');
-  console.log('  2. Conditional rendering based on client-only APIs (window, navigator, etc.)');
-  console.log('  3. Missing or incorrect attributes in client-side render');
-  console.log('  4. Random values or timestamps generated during render');
-  console.log('  5. Missing data-ssr guard in connectedCallback');
-
-  console.log('\n\x1b[36mSuggestions:\x1b[0m');
-  console.log('  • Ensure server and client render with same props/state');
-  console.log('  • Use typeof window !== "undefined" checks for browser APIs');
-  console.log('  • Avoid random values or Date.now() in render logic');
-  console.log('  • Verify data-ssr attribute is present on server-rendered elements');
-
-  console.log('\n\x1b[34mLearn more:\x1b[0m https://mastercontroller.dev/docs/hydration#mismatches');
-  console.groupEnd();
-
-  // Log to monitoring service
-  if (typeof window !== 'undefined' && window.masterControllerErrorReporter) {
-    window.masterControllerErrorReporter({
-      type: 'hydration-mismatch',
-      component: mismatch.component,
-      diffCount: diff.length,
-      attrMismatchCount: attrMismatches.length
-    });
-  }
-}
-
-/**
- * Scan all SSR components for hydration mismatches
- */
-function scanForHydrationMismatches(options = {}) {
-  if (!isDevelopment) return;
-
-  const ssrElements = document.querySelectorAll('[data-ssr]');
-  const mismatches = [];
-
-  ssrElements.forEach(element => {
-    const componentName = element.tagName.toLowerCase();
-    const mismatch = detectHydrationMismatch(element, componentName, options);
-
-    if (mismatch) {
-      mismatches.push(mismatch);
-      reportHydrationMismatch(mismatch, options);
-    }
-  });
-
-  if (mismatches.length === 0 && options.verbose) {
-    console.log('\x1b[32m✓ No hydration mismatches detected\x1b[0m');
-  }
-
-  return mismatches;
-}
-
-/**
- * Enable automatic hydration mismatch detection
- */
-function enableHydrationMismatchDetection(options = {}) {
-  if (!isDevelopment) return;
-
-  // Run check after hydration completes
-  if (typeof window !== 'undefined') {
-    window.addEventListener('load', () => {
-      setTimeout(() => {
-        scanForHydrationMismatches(options);
-      }, options.delay || 1000);
-    });
-  }
-}
-
-// Auto-enable in development
-if (typeof window !== 'undefined' && isDevelopment) {
-  enableHydrationMismatchDetection({
-    verbose: localStorage.getItem('mc-hydration-debug') === 'true'
-  });
-}
-
-module.exports = {
-  detectHydrationMismatch,
-  reportHydrationMismatch,
-  scanForHydrationMismatches,
-  enableHydrationMismatchDetection,
-  generateDiff,
-  compareAttributes
-};

package/error/MasterError.js

@@ -1,240 +0,0 @@
-
-// version 1.0.21 - improved console/error logging with syntax error code frames
-var winston = require('winston');
-var fileserver = require('fs');
-const { request } = require('http');
-
-class MasterError{
-    logger = "";
-    statuses = [];
-
-    // Lazy-load master to avoid circular dependency (Google-style lazy initialization)
-    get _master() {
-        if (!this.__masterCache) {
-            this.__masterCache = require('../MasterControl');
-        }
-        return this.__masterCache;
-    }
-
-    init(error){
-        var that = this;
-        var stat = error;
-        this.addStatuses(stat);
-
-        this.logger = winston.createLogger({
-            format: winston.format.json(),
-            transports: [
-                  new winston.transports.Console(),
-                  new winston.transports.File({ filename: `${this._master.root}/log/${this._master.environmentType}.log` })
-              ]
-          });
-        
-		// Global error handlers with better diagnostics (stack and code frame)
-		process.on('uncaughtException', function (err) {
-			that._reportError(err, 'uncaughtException');
-		});
-
-		// will catch all promise exceptions
-		process.on('unhandledRejection', function (reason, promise) {
-			that._reportError(reason instanceof Error ? reason : new Error(String(reason)), 'unhandledRejection');
-		});
-
-		process.on('rejectionHandled', function (reason, promise) {
-			that._reportError(reason instanceof Error ? reason : new Error(String(reason)), 'rejectionHandled');
-		});
-
-		process.on('warning', function (warning) {
-			that._reportError(warning instanceof Error ? warning : new Error(String(warning)), 'warning');
-		});
-        
-    }
-
-    clearStatuses(){
-        this.statuses = [];
-    }
-
-    // add error status functions
-    addStatuses(status){
-        // loop through object and add all codes
-        for (var code in status) {
-            // skip loop if the property is from prototype
-            if (!status.hasOwnProperty(code)) continue;
-
-            this.statuses.push({
-                code: code,
-                route : status[code]
-            });
-           
-        }
-    }
-
-    // call error status by status code
-    callHttpStatus(statusCode, response){
-        try{
-
-            var status = this.statuses;
-            var res = response;
-            if(status.length !== 0){
-                if(Number.isInteger(statusCode) ){
-                    for (var i = 0; i < status.length; i++) {
-                            if(parseInt(status[i].code) === statusCode){
-                                var location = status[i].route;
-                                var html = fileserver.readFileSync(`${this._master.root}/${status[i].route.replace(/^\/|\/$/g, '')}`, 'utf8' );
-                                if (!res.headersSent) {
-                                        res.writeHead(200, {'Content-Type': 'text/html'});
-                                        res.write(html, 'utf8');
-                                        res.end();
-                                }
-                            }
-                    };
-                }
-                else{
-                    this.log("The HTTP status added is not a number","error");
-                    throw "The HTTP status added is not a number";
-                }
-            }
-            else{
-                this.log("No error http statuses have been added", "error");
-                throw "No error http statuses have been added";
-            }
-        }
-        catch(err){
-            throw err;
-        }
-    }
-
-    // log your error
-    log(msg, level){
-
-        var level = level === undefined ? "info": level;
-        if(msg === undefined){
-            throw "error has been thrown with no message.";
-        };
-        if(this.logger === ""){
-            throw "error init function has not been called.";
-        };
-        
-        var message = msg.message === undefined ? msg : msg.message;
-    
-        this.logger.log({
-            level: level,
-            message: message,
-            stack : msg.stack
-        });
-    }
-
-	// Enhanced error reporter: logs formatted stack and nearby source code
-	_reportError(err, tag){
-		try{
-			const name = err && err.name ? err.name : 'Error';
-			const message = err && err.message ? err.message : String(err);
-			const stack = err && err.stack ? String(err.stack) : '';
-			const header = `[${tag}] ${name}: ${message}`;
-			console.error('\u001b[31m' + header + '\u001b[0m');
-			if (stack) {
-				console.error(stack);
-				const loc = this._extractTopFrame(stack);
-				if (loc && loc.file && loc.line) {
-					const frame = this._buildCodeFrame(loc.file, loc.line, loc.column);
-					if (frame) {
-						console.error('\n\u001b[33mCode frame:\u001b[0m');
-						console.error(frame);
-					}
-				}
-			}
-			this.log(err, 'error');
-		} catch(e){
-			try { console.error('Error while reporting error:', e); } catch(_) {}
-		}
-	}
-
-	_extractTopFrame(stack){
-		try{
-			const lines = stack.split('\n');
-			for (let i = 0; i < lines.length; i++) {
-				const m = lines[i].match(/\((.*):(\d+):(\d+)\)/) || lines[i].match(/at ([^\s]+):(\d+):(\d+)/);
-				if (m) {
-					return { file: m[1], line: parseInt(m[2]), column: parseInt(m[3]||'0') };
-				}
-			}
-			return null;
-		} catch(_) { return null; }
-	}
-
-	_buildCodeFrame(file, line, column){
-		try{
-			if (!fileserver.existsSync(file)) return null;
-			const src = fileserver.readFileSync(file, 'utf8').split(/\r?\n/);
-			const start = Math.max(1, line - 3);
-			const end = Math.min(src.length, line + 3);
-			const digits = String(end).length;
-			let out = '';
-			for (let i = start; i <= end; i++) {
-				const prefix = (i === line ? '>' : ' ') + String(i).padStart(digits, ' ') + ' | ';
-				out += prefix + src[i - 1] + '\n';
-				if (i === line && column && column > 0) {
-					out += ' '.repeat(prefix.length + column - 1) + '^\n';
-				}
-			}
-			return out;
-		} catch(_) { return null; }
-	}
-}
-
-module.exports = { MasterError };
-
-// ================ CODES YOU CAN USE ================ //
-// ACCEPTED    202 Accepted
-// BAD_GATEWAY 502 Bad Gateway
-// BAD_REQUEST 400 Bad Request
-// CONFLICT    409 Conflict
-// CONTINUE    100 Continue
-// CREATED 201 Created
-// EXPECTATION_FAILED  417 Expectation Failed
-// FAILED_DEPENDENCY   424 Failed Dependency
-// FORBIDDEN   403 Forbidden
-// GATEWAY_TIMEOUT 504 Gateway Timeout
-// GONE    410 Gone
-// HTTP_VERSION_NOT_SUPPORTED  505 HTTP Version Not Supported
-// IM_A_TEAPOT 418 I'm a teapot
-// INSUFFICIENT_SPACE_ON_RESOURCE  419 Insufficient Space on Resource
-// INSUFFICIENT_STORAGE    507 Insufficient Storage
-// INTERNAL_SERVER_ERROR   500 Server Error
-// LENGTH_REQUIRED 411 Length Required
-// LOCKED  423 Locked
-// METHOD_FAILURE  420 Method Failure
-// METHOD_NOT_ALLOWED  405 Method Not Allowed
-// MOVED_PERMANENTLY   301 Moved Permanently
-// MOVED_TEMPORARILY   302 Moved Temporarily
-// MULTI_STATUS    207 Multi-Status
-// MULTIPLE_CHOICES    300 Multiple Choices
-// NETWORK_AUTHENTICATION_REQUIRED 511 Network Authentication Required
-// NO_CONTENT  204 No Content
-// NON_AUTHORITATIVE_INFORMATION   203 Non Authoritative Information
-// NOT_ACCEPTABLE  406 Not Acceptable
-// NOT_FOUND   404 Not Found
-// NOT_IMPLEMENTED 501 Not Implemented
-// NOT_MODIFIED    304 Not Modified
-// OK  200 OK
-// PARTIAL_CONTENT 206 Partial Content
-// PAYMENT_REQUIRED    402 Payment Required
-// PERMANENT_REDIRECT  308 Permanent Redirect
-// PRECONDITION_FAILED 412 Precondition Failed
-// PRECONDITION_REQUIRED   428 Precondition Required
-// PROCESSING  102 Processing
-// PROXY_AUTHENTICATION_REQUIRED   407 Proxy Authentication Required
-// REQUEST_HEADER_FIELDS_TOO_LARGE 431 Request Header Fields Too Large
-// REQUEST_TIMEOUT 408 Request Timeout
-// REQUEST_TOO_LONG    413 Request Entity Too Large
-// REQUEST_URI_TOO_LONG    414 Request-URI Too Long
-// REQUESTED_RANGE_NOT_SATISFIABLE 416 Requested Range Not Satisfiable
-// RESET_CONTENT   205 Reset Content
-// SEE_OTHER   303 See Other
-// SERVICE_UNAVAILABLE 503 Service Unavailable
-// SWITCHING_PROTOCOLS 101 Switching Protocols
-// TEMPORARY_REDIRECT  307 Temporary Redirect
-// TOO_MANY_REQUESTS   429 Too Many Requests
-// UNAUTHORIZED    401 Unauthorized
-// UNPROCESSABLE_ENTITY    422 Unprocessable Entity
-// UNSUPPORTED_MEDIA_TYPE  415 Unsupported Media Type
-// USE_PROXY   305 Use Proxy