errlens 1.0.2 → 1.0.4

package/README.md

@@ -1,15 +1,38 @@
 # ErrLens 🔍  
 > **Translate cryptic JavaScript errors into human-readable solutions instantly.**
 
-<p align="left">
-  <img src="https://img.shields.io/npm/v/errlens?style=flat-square&color=007acc" alt="npm version">
-  <img src="https://img.shields.io/github/license/BeyteFlow/errlens?style=flat-square&color=42b883" alt="license">
-  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome">
+<p align="center">
+  <img src="assets/errlens.png" width="500">
 </p>
+</br>
+</br>
 
+<p align="center">
+  <!-- GitHub Badges -->
+  <img src="https://img.shields.io/github/stars/BeyteFlow/errlens?style=for-the-badge" alt="GitHub stars">
+  <img src="https://img.shields.io/github/forks/BeyteFlow/errlens?style=for-the-badge" alt="GitHub forks">
+  <img src="https://img.shields.io/github/issues/BeyteFlow/errlens?style=for-the-badge" alt="GitHub issues">
+  <img src="https://img.shields.io/github/license/BeyteFlow/errlens?style=for-the-badge" alt="GitHub license">
+  <img src="https://img.shields.io/github/issues-pr/BeyteFlow/errlens?style=for-the-badge" alt="Open PRs">
+  
+  <!-- npm Badges -->
+  <br>
+  <img src="https://img.shields.io/npm/v/errlens?style=for-the-badge" alt="npm version">
+  <img src="https://img.shields.io/npm/dm/errlens?style=for-the-badge" alt="npm downloads">
+  <img src="https://img.shields.io/github/v/tag/BeyteFlow/errlens?style=for-the-badge" alt="Git tag version">
+  <img src="https://img.shields.io/node/v/errlens?style=for-the-badge" alt="Node.js version">
+</p>
 **ErrLens** is a professional-grade CLI utility designed to eliminate developer frustration. It intercepts Node.js crashes, analyzes stack traces, and delivers plain-English explanations with actionable fixes—directly in your terminal.
 
 ---
+</br>
+</br>
+</br>
+<p align="center">
+  <img src="assets/terminal.png" width="800">
+</p>
+</br>
+</br>
 
 ## 🌟 Key Features
 

package/bin/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 
 const { Command } = require("commander");
+const { spawn } = require("child_process");
 const ora = require("ora");
 const chalk = require("chalk");
+const path = require("path");
 const { findError } = require("../lib/matcher");
 const { formatError } = require("../lib/formatter");
 
@@ -10,39 +12,64 @@ const program = new Command();
 
 program
   .name("errlens")
-  .description("Professional JS error analysis for the terminal")
-  .version("1.1.0")
-  .argument("[error]", "The error message to analyze")
-  .option("-j, --json", "Output results in raw JSON format") // For automation
-  .action((errorInput, options) => {
-    // If no argument is provided, show help and exit
-    if (!errorInput) {
-      program.help();
-      return;
-    }
-
-    // JSON Mode (No spinner, no colors, just data)
-    if (options.json) {
-      const result = findError(errorInput);
-      console.log(JSON.stringify(result || { error: "No match found" }, null, 2));
-      return;
-    }
-
-    // Standard Mode
-    const spinner = ora({ text: "Analyzing error trace...", color: "cyan" }).start();
-
-    setTimeout(() => {
-      const result = findError(errorInput);
-
-      if (!result) {
-        spinner.fail(chalk.red(" Analysis Failed: Error not found in database."));
-        console.log(chalk.dim("\nTry searching a shorter snippet of the error message."));
+  .description("Professional JS Error Analytics")
+  .version("1.3.1");
+
+program
+  .command("run <file>")
+  .description("Run a Javascript file and analyze crashes")
+  .action((file) => {
+    const filePath = path.resolve(process.cwd(), file);
+    const spinner = ora(`Running ${chalk.yellow(file)}...`).start();
+    
+    // stdio: ['inherit', 'pipe', 'pipe'] 
+    // This allows us to pipe stdout and stderr while keeping the process interactive
+    const child = spawn(process.execPath, [filePath], { stdio: ["inherit", "pipe", "pipe"] });
+
+    let errorOutput = "";
+
+    // Stream logs to terminal in REAL-TIME
+    child.stdout.on("data", (data) => {
+      // Clear spinner temporarily to print log, then restart (better UX)
+      spinner.stop();
+      process.stdout.write(data);
+      spinner.start();
+    });
+
+    // Capture stderr for analysis
+    child.stderr.on("data", (data) => {
+      errorOutput += data.toString();
+    });
+
+    child.on("close", (code, signal) => {
+      spinner.stop();
+
+      if (code === null) {
+        console.log(chalk.red.bold(`\n⚠️ Process killed by signal: ${signal}`));
+        process.exit(1);
         return;
       }
 
-      spinner.succeed(chalk.bold("Analysis complete!"));
-      console.log(formatError(result));
-    }, 500);
+      if (code === 0) {
+        console.log(chalk.green.bold("\n✨ Process finished successfully."));
+      } else {
+        const { count, matches } = findError(errorOutput);
+
+        if (count > 0) {
+          console.log(chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`));
+          matches.forEach(m => console.log(formatError(m)));
+        } else {
+          console.log(chalk.red.bold("\n❌ Crash detected (No known fix in database):"));
+          console.log(chalk.gray(errorOutput));
+        }
+      }
+      process.exit(code ?? 1);
+    });
+
+    child.on("error", (err) => {
+      spinner.fail(chalk.red(`System Error: ${err.message}`));
+      process.exit(1);
+    });
   });
 
 program.parse(process.argv);

package/lib/auto.js

@@ -1,15 +1,18 @@
-// lib/auto.js
 const { findError } = require("./matcher");
 const { formatError } = require("./formatter");
+const chalk = require("chalk");
 
-// This listens for any crash that wasn't caught by a try/catch
 process.on("uncaughtException", (err) => {
-  const result = findError(err.message);
+  // Use the message for the search, guard against non-Error throws
+  const msg = (err && err.message) ? err.message : String(err);
+  const { count, matches } = findError(msg);
   
-  if (result) {
-    console.log("\n--- ErrLens Auto-Detection ---");
-    console.log(formatError(result));
+  if (count > 0) {
+    console.log(chalk.cyan(`\n💡 ErrLens detected ${count} issue(s):`));
+    matches.forEach(match => console.log(formatError(match)));
   } else {
+    // If no match, show the raw error so you know what happened
+    console.error(chalk.red.bold("\n--- Raw System Error ---"));
     console.error(err);
   }
   process.exit(1);

package/lib/database.json

@@ -2,37 +2,430 @@
   {
     "name": "TypeError: Cannot read properties of undefined",
     "match": "Cannot read properties of undefined",
-    "explanation": "You are trying to access a property (like .map, .length, or .id) on a variable that currently holds no value.",
-    "why": "The variable wasn't initialized, an API call hasn't finished yet, or a function returned nothing.",
+    "explanation": "You are trying to access a property on a variable that is currently empty.",
+    "why": "The variable wasn't initialized, or an API call hasn't finished yet.",
     "fixes": [
-      "Use optional chaining: user?.profile",
-      "Set a default value: const list = data || []",
-      "Check if the variable exists: if (data) { ... }"
+      "Use optional chaining: user?.name",
+      "Set a default value: data || []"
     ],
-    "example": "const name = user?.info?.name || 'Guest';"
+    "example": "const name = user?.name || 'Guest';"
   },
   {
     "name": "ReferenceError: x is not defined",
     "match": "is not defined",
-    "explanation": "You're trying to use a variable that hasn't been declared in the current scope.",
-    "why": "Possible typo in the variable name, or the variable is scoped inside another function/block.",
-    "fixes": [
-      "Check for typos in the variable name",
-      "Ensure the variable is declared with const, let, or var",
-      "Check if the variable is defined outside the current function"
-    ],
-    "example": "const myVar = 10;\nconsole.log(myVar); // Ensure name matches exactly"
+    "explanation": "You're using a variable that hasn't been declared.",
+    "why": "Typo in the name or the variable is scoped inside another function.",
+    "fixes": ["Check for typos", "Declare with const/let"],
+    "example": "const myVar = 10;\nconsole.log(myVar);"
   },
   {
     "name": "TypeError: x is not a function",
     "match": "is not a function",
-    "explanation": "You tried to call a variable as if it were a function, but it's a different data type (like a String or Object).",
-    "why": "Often happens when an import fails or when a callback isn't passed correctly.",
+    "explanation": "You called a variable as a function, but it's another type (String/Object).",
+    "why": "Import failed or a callback wasn't passed correctly.",
+    "fixes": ["Check imports", "Verify type with typeof"],
+    "example": "if (typeof fn === 'function') fn();"
+  },
+  {
+    "name": "Error: Cannot find module",
+    "match": "Cannot find module",
+    "explanation": "Node.js cannot find the file or package you are importing.",
+    "why": "The package isn't installed or the relative path is wrong.",
+    "fixes": ["Run 'npm install'", "Check file path spelling"],
+    "example": "require('./src/utils.js');"
+  },
+  {
+    "name": "Error: EADDRINUSE (Port Taken)",
+    "match": "EADDRINUSE",
+    "explanation": "The port your server wants is already being used.",
+    "why": "Another instance of your app is already running.",
+    "fixes": ["Kill the other process", "Change the port number"],
+    "example": "const PORT = process.env.PORT || 4000;"
+  },
+  {
+    "name": "RangeError: Maximum call stack size exceeded",
+    "match": "Maximum call stack size exceeded",
+    "explanation": "The call stack limit was reached due to excessive recursion or a very deep call chain.",
+    "why": "A recursive function is calling itself too many times without hitting a base case, or a chain of function calls builds up too deeply.",
+    "fixes": ["Check recursion exit conditions", "Verify recursive base cases are reachable", "Check call-chain depth and stack-building loops"],
+    "example": "function run() { if (done) return; run(); }"
+  },
+  {
+    "name": "Error: ECONNREFUSED",
+    "match": "ECONNREFUSED",
+    "explanation": "Your app tried to connect to a database/API but was rejected.",
+    "why": "The target server is down or the URL is wrong.",
+    "fixes": ["Ensure DB is running", "Check API URL"],
+    "example": "mongoose.connect('mongodb://localhost:27017/db');"
+  },
+  {
+    "name": "TypeError: Assignment to constant variable",
+    "match": "Assignment to constant variable",
+    "explanation": "You tried to change a 'const' variable.",
+    "why": "Const variables cannot be reassigned.",
+    "fixes": ["Use 'let' instead of 'const'"],
+    "example": "let count = 0; count = 1;"
+  },
+  {
+    "name": "Error: ENOENT (No such file)",
+    "match": "ENOENT",
+    "explanation": "You're trying to read a file that doesn't exist.",
+    "why": "File moved or path string is incorrect.",
+    "fixes": ["Verify file exists", "Use path.join()"],
+    "example": "fs.readFileSync(path.join(__dirname, 'log.txt'));"
+  },
+  {
+    "name": "SyntaxError: await is only valid in async functions",
+    "match": "await is only valid in async functions",
+    "explanation": "You used 'await' inside a normal function.",
+    "why": "Await requires the 'async' keyword on the parent function.",
+    "fixes": ["Add 'async' to function definition"],
+    "example": "async function start() { await call(); }"
+  },
+  {
+    "name": "Error [ERR_HTTP_HEADERS_SENT]",
+    "match": "ERR_HTTP_HEADERS_SENT",
+    "explanation": "You sent a response after already sending one.",
+    "why": "Multiple res.send() calls in one route.",
+    "fixes": ["Use 'return res.send()' to stop execution"],
+    "example": "if (err) return res.send(err); res.send(ok);"
+  },
+  {
+    "name": "MongooseError: Operation `x.findOne()` buffering timed out",
+    "match": "buffering timed out",
+    "explanation": "Mongoose couldn't connect to MongoDB in time.",
+    "why": "Database is offline or connection string is wrong.",
+    "fixes": ["Check MongoDB status", "Check connection string"],
+    "example": "mongoose.connect(process.env.MONGO_URI);"
+  },
+  {
+    "name": "JsonWebTokenError: jwt malformed",
+    "match": "jwt malformed",
+    "explanation": "The token provided is not a valid JWT structure.",
+    "why": "Token is corrupted or only part of it was sent.",
+    "fixes": ["Check 'Authorization' header", "Verify token generation"],
+    "example": "const token = req.headers.authorization.split(' ')[1];"
+  },
+  {
+    "name": "Error: secretOrPrivateKey must have a value",
+    "match": "secretOrPrivateKey must have a value",
+    "explanation": "JWT secret key is missing.",
+    "why": "Environment variable (JWT_SECRET) is not loaded.",
+    "fixes": ["Check .env file", "Run dotenv.config()"],
+    "example": "jwt.sign(p, process.env.JWT_SECRET);"
+  },
+  {
+    "name": "MongoServerError: E11000 duplicate key error",
+    "match": "E11000",
+    "explanation": "You're saving data with a 'unique' field that already exists.",
+    "why": "Usually a duplicate Email or Username in the DB.",
+    "fixes": [
+      "Check if data exists before saving",
+      "Use unique error handling"
+    ],
+    "example": "UserSchema.path('email').validate(...) "
+  },
+  {
+    "name": "SyntaxError: Unexpected token < in JSON",
+    "match": "Unexpected token < in JSON",
+    "explanation": "You tried to parse JSON, but got HTML instead.",
+    "why": "Your API returned an error page (HTML) instead of data (JSON).",
+    "fixes": ["Check the API URL", "Check server logs for crashes"],
+    "example": "fetch(url).then(res => res.json())"
+  },
+  {
+    "name": "Error: Cross-Origin Request Blocked (CORS)",
+    "match": "CORS",
+    "explanation": "Browser blocked your request for security reasons.",
+    "why": "The server doesn't allow requests from your frontend domain.",
+    "fixes": ["Install 'cors' package on server", "app.use(cors())"],
+    "example": "const cors = require('cors'); app.use(cors());"
+  },
+  {
+    "name": "TypeError: Cannot read property 'map' of undefined",
+    "match": "'map' of undefined",
+    "explanation": "You're trying to loop through an array that doesn't exist.",
+    "why": "The variable is null/undefined instead of an Array.",
+    "fixes": ["Initialize as empty array: data || []", "Check API response"],
+    "example": "items?.map(item => ...)"
+  },
+  {
+    "name": "Error: module not found 'dotenv'",
+    "match": "module not found 'dotenv'",
+    "explanation": "The 'dotenv' package is missing.",
+    "why": "You used it in code but didn't install it.",
+    "fixes": ["npm install dotenv"],
+    "example": "require('dotenv').config();"
+  },
+  {
+    "name": "ValidationError: User validation failed",
+    "match": "validation failed",
+    "explanation": "Data doesn't match your Mongoose schema.",
+    "why": "Missing required fields or wrong data types.",
+    "fixes": ["Check required fields", "Validate data on frontend"],
+    "example": "new User({ name: 'x' }).save();"
+  },
+  {
+    "name": "Error: Not authorized",
+    "match": "not authorized",
+    "explanation": "Access denied because of missing or invalid credentials.",
+    "why": "Token expired or wrong API key.",
+    "fixes": ["Login again", "Check headers"],
+    "example": "res.status(401).send('Unauthorized');"
+  },
+  {
+    "name": "Error: Request failed with status code 404",
+    "match": "status code 404",
+    "explanation": "The API endpoint you are calling doesn't exist.",
+    "why": "Wrong URL or the server route isn't defined.",
+    "fixes": ["Check API route spelling", "Check Base URL"],
+    "example": "axios.get('/api/users');"
+  },
+  {
+    "name": "Error: Request failed with status code 500",
+    "match": "status code 500",
+    "explanation": "The server crashed while processing your request.",
+    "why": "A bug on the backend server code.",
+    "fixes": ["Check server console logs", "Add try/catch on server"],
+    "example": "try { ... } catch (e) { res.status(500) }"
+  },
+  {
+    "name": "TypeError: object is not iterable",
+    "match": "is not iterable",
+    "explanation": "You used a for...of loop or spread (...) on a non-array.",
+    "why": "You tried to iterate over an Object or Null.",
+    "fixes": ["Ensure variable is an Array", "Use Object.keys()"],
+    "example": "[...myArray]"
+  },
+  {
+    "name": "ReferenceError: require is not defined",
+    "match": "require is not defined",
+    "explanation": "You're using 'require' in an ES Module.",
+    "why": "Node.js is set to 'type': 'module' in package.json.",
+    "fixes": ["Use 'import' instead", "Remove 'type: module'"],
+    "example": "import fs from 'fs';"
+  },
+  {
+    "name": "Error: Permission denied (EACCES)",
+    "match": "EACCES",
+    "explanation": "You don't have permission to access this file/port.",
+    "why": "You need admin rights or the file is locked.",
+    "fixes": ["Use 'sudo' (Linux/Mac)", "Check file permissions"],
+    "example": "chmod +x script.js"
+  },
+  {
+    "name": "SyntaxError: Identifier 'x' has already been declared",
+    "match": "has already been declared",
+    "explanation": "You declared the same variable name twice.",
+    "why": "Using 'let' or 'const' on a name that exists in the same scope.",
+    "fixes": ["Rename one of the variables", "Remove the second declaration"],
+    "example": "let x = 1; x = 2; // Don't use let again"
+  },
+  {
+    "name": "Error: PayloadTooLargeError",
+    "match": "PayloadTooLargeError",
+    "explanation": "The data you sent is too big for the server.",
+    "why": "Usually an image or file that exceeds the body-parser limit.",
+    "fixes": ["Increase limit: app.use(express.json({limit: '50mb'}))"],
+    "example": "app.use(express.json({ limit: '10mb' }));"
+  },
+  {
+    "name": "TypeError: Cannot set property of null",
+    "match": "set property of null",
+    "explanation": "You're trying to give a value to a property of an empty variable.",
+    "why": "The object you're modifying hasn't been created yet.",
+    "fixes": ["Initialize the object first", "Check for null"],
+    "example": "const obj = {}; obj.prop = 1;"
+  },
+  {
+    "name": "Error: socket hang up",
+    "match": "socket hang up",
+    "explanation": "The server closed the connection unexpectedly.",
+    "why": "Server crashed or timeout occurred.",
+    "fixes": ["Check server health", "Increase timeout limit"],
+    "example": "axios.get(url, { timeout: 5000 });"
+  },
+  {
+    "name": "SyntaxError: Unexpected end of JSON input",
+    "match": "Unexpected end of JSON input",
+    "explanation": "The JSON data is incomplete or empty.",
+    "why": "The server sent an empty string instead of JSON.",
+    "fixes": ["Check API response body", "Handle empty responses"],
+    "example": "if (text) JSON.parse(text);"
+  },
+  {
+    "name": "Error: Script execution timed out",
+    "match": "Script execution timed out",
+    "explanation": "Your code took too long to run.",
+    "why": "Heavy computation or infinite loop.",
+    "fixes": ["Optimize logic", "Use worker threads"],
+    "example": "setTimeout(() => { ... }, 1000);"
+  },
+  {
+    "name": "TypeError: Cannot read property 'then' of undefined",
+    "match": "'then' of undefined",
+    "explanation": "You called .then() on something that isn't a Promise.",
+    "why": "The function didn't return a promise.",
+    "fixes": ["Make function 'async'", "Return a Promise"],
+    "example": "return new Promise(...) "
+  },
+  {
+    "name": "Error: Invalid connection string",
+    "match": "Invalid connection string",
+    "explanation": "The database URL format is wrong.",
+    "why": "Missing symbols like '@' or '/' in the URI.",
+    "fixes": ["Check DB URI format"],
+    "example": "mongodb+srv://user:pass@cluster..."
+  },
+  {
+    "name": "ReferenceError: window is not defined",
+    "match": "window is not defined",
+    "explanation": "You're trying to use browser code (window) in Node.js.",
+    "why": "Node.js doesn't have a 'window' object (that's for browsers).",
+    "fixes": ["Check if running in browser", "Use 'global' instead"],
+    "example": "if (typeof window !== 'undefined') { ... }"
+  },
+  {
+    "name": "Error: Too many listeners",
+    "match": "Too many listeners",
+    "explanation": "Memory leak detected in EventEmitters.",
+    "why": "Adding event listeners inside a loop or repeated function.",
+    "fixes": ["Use .once() instead of .on()", "Remove old listeners"],
+    "example": "emitter.setMaxListeners(20);"
+  },
+  {
+    "name": "TypeError: Cannot spread non-iterable object",
+    "match": "spread non-iterable",
+    "explanation": "You tried to use `...obj` where it's not allowed.",
+    "why": "Trying to spread an object into an array.",
+    "fixes": ["Use brackets [] for arrays and {} for objects"],
+    "example": "const newObj = { ...oldObj };"
+  },
+  {
+    "name": "Error: write EPIPE",
+    "match": "EPIPE",
+    "explanation": "Broken pipe: sending data to a closed connection.",
+    "why": "The other side (client/process) stopped listening.",
+    "fixes": ["Handle stream errors", "Check if process is alive"],
+    "example": "stream.on('error', (err) => { ... })"
+  },
+  {
+    "name": "SyntaxError: Missing initializer in const declaration",
+    "match": "Missing initializer",
+    "explanation": "You declared a const without giving it a value.",
+    "why": "Const must be set immediately when created.",
+    "fixes": ["Assign a value: const x = 1;"],
+    "example": "const x = 5;"
+  },
+  {
+    "name": "Error: npm ERR! peerinvalid",
+    "match": "peerinvalid",
+    "explanation": "Installed packages have conflicting versions.",
+    "why": "One library needs version A, another needs version B.",
+    "fixes": ["npm install --legacy-peer-deps"],
+    "example": "npm install package --force"
+  },
+  {
+    "name": "TypeError: data.filter is not a function",
+    "match": "filter is not a function",
+    "explanation": "You're trying to filter something that isn't an array.",
+    "why": "The variable is an Object or Null.",
+    "fixes": ["Ensure data is an Array: Array.isArray(data)"],
+    "example": "(data || []).filter(...)"
+  },
+  {
+    "name": "Error: Hostname not found (ENOTFOUND)",
+    "match": "ENOTFOUND",
+    "explanation": "DNS lookup failed for the URL.",
+    "why": "Typo in the URL or no internet connection.",
+    "fixes": ["Check URL spelling", "Check DNS/Internet"],
+    "example": "axios.get('https://api.example.com')"
+  },
+  {
+    "name": "SyntaxError: Unexpected reserved word",
+    "match": "reserved word",
+    "explanation": "You used a word saved for JS (like 'class' or 'await') as a variable name.",
+    "why": "You can't name a variable 'class' or 'function'.",
+    "fixes": ["Rename the variable"],
+    "example": "const myClass = 'math';"
+  },
+  {
+    "name": "Error: Cannot find name 'x'",
+    "match": "Cannot find name",
+    "explanation": "TypeScript cannot find this variable or type.",
+    "why": "Variable not declared or missing @types package.",
+    "fixes": ["Check imports", "Install types: npm install @types/node"],
+    "example": "import { x } from './file';"
+  },
+  {
+    "name": "TypeError: Cannot convert undefined or null to object",
+    "match": "convert undefined or null to object",
+    "explanation": "Calling Object methods on an empty variable.",
+    "why": "Using Object.keys(data) when data is null.",
+    "fixes": ["Check if data exists: data && Object.keys(data)"],
+    "example": "Object.entries(data || {})"
+  },
+  {
+    "name": "Error: No 'Access-Control-Allow-Origin' header",
+    "match": "Access-Control-Allow-Origin",
+    "explanation": "CORS error: Server isn't sharing data with your domain.",
+    "why": "Security policy on the backend.",
+    "fixes": ["Enable CORS on the server side"],
+    "example": "res.header('Access-Control-Allow-Origin', '*');"
+  },
+  {
+    "name": "SyntaxError: Invalid or unexpected token",
+    "match": "Invalid or unexpected token",
+    "explanation": "There is a character in your code that shouldn't be there.",
+    "why": "Copy-pasting hidden symbols or using smart quotes (” instead of \").",
+    "fixes": ["Retype the line manually", "Check for invisible symbols"],
+    "example": "const str = 'hello';"
+  },
+  {
+    "name": "Error: Timeout of 2000ms exceeded (Mocha/Jest)",
+    "match": "timeout of 2000ms exceeded",
+    "explanation": "Your test took too long to finish.",
+    "why": "Asynchronous code didn't call 'done()' or finish in time.",
+    "fixes": ["Increase test timeout", "Check for slow API calls"],
+    "example": "it('test', () => { ... }).timeout(5000);"
+  },
+  {
+    "name": "TypeError: Property 'x' does not exist on type 'y'",
+    "match": "does not exist on type",
+    "explanation": "TypeScript Error: Accessing a property that isn't in the Interface.",
+    "why": "The object structure doesn't match the TS Type definition.",
+    "fixes": ["Update the Interface", "Use type casting: (obj as any).prop"],
+    "example": "interface User { name: string }"
+  },
+  {
+    "name": "Error: npm ERR! 404 Not Found",
+    "match": "npm ERR! 404",
+    "explanation": "NPM can't find the package you want to install.",
+    "why": "Typo in the package name or it's a private package.",
+    "fixes": ["Check package spelling", "npm login"],
+    "example": "npm install express"
+  },
+  {
+    "name": "SyntaxError: Unexpected end of input",
+    "match": "Unexpected end of input",
+    "explanation": "Your code stopped abruptly, likely due to a missing closing bracket.",
+    "why": "You opened a ( [ or { but forgot to close it with ) ] or }.",
+    "fixes": [
+      "Check for missing closing parentheses )",
+      "Check for missing curly braces }",
+      "Ensure all quotes ' or \" are closed"
+    ],
+    "example": "console.log('Hello'); // Make sure the ) is there!"
+  },
+  {
+    "name": "SyntaxError: Missing Parenthesis",
+    "match": "missing ) after argument list",
+    "explanation": "You forgot to close a function call with a ')'.",
+    "why": "A parenthesis was opened but the line ended or another symbol appeared before it was closed.",
     "fixes": [
-      "Verify the variable is actually a function with typeof",
-      "Check your imports/requires",
-      "Ensure you aren't overwriting the function name with a value"
+      "Add a ')' at the end of your function call",
+      "Check if you accidentally deleted a ')' while typing"
     ],
-    "example": "if (typeof callback === 'function') {\n  callback();\n}"
+    "example": "console.log('Hello');"
   }
-]
+]

package/lib/formatter.js

@@ -2,20 +2,15 @@ const chalk = require("chalk");
 const boxen = require("boxen");
 
 function formatError(error) {
-  const fixList = error.fixes
-    .map(fix => chalk.green(`  ✔ ${fix}`))
-    .join("\n");
+  const fixList = error.fixes.map(f => chalk.green(`  ✔ ${f}`)).join("\n");
 
   const content = `
 ${chalk.cyan.bold("ID:")} ${error.name}
 
-${chalk.yellow.bold("🔍 WHAT HAPPENED:")}
-${error.explanation}
+${chalk.yellow.bold("🔍 WHAT:")} ${error.explanation}
+${chalk.magenta.bold("💥 WHY:")} ${error.why}
 
-${chalk.magenta.bold("💥 WHY:")}
-${error.why}
-
-${chalk.green.bold("✅ COMMON FIXES:")}
+${chalk.green.bold("✅ FIXES:")}
 ${fixList}
 
 ${chalk.blue.bold("📘 EXAMPLE:")}
@@ -24,11 +19,12 @@ ${chalk.gray(error.example)}
 
   return boxen(content, {
     padding: 1,
-    margin: 1,
+    margin: { top: 1, bottom: 1 },
     borderStyle: "round",
     borderColor: "cyan",
-    title: "ErrLens Analysis",
-    titleAlignment: "center"
+    title: chalk.bold("🔍 ErrLens Analysis"),
+    titleAlignment: "left",
+    width: 80 // Fixed width for consistent professional look
   });
 }
 

package/lib/injector.js

@@ -0,0 +1,43 @@
+const { findError } = require("./matcher");
+const { formatError } = require("./formatter");
+const chalk = require("chalk");
+
+/**
+ * ERR_LENS INJECTOR
+ * Attach this to any project to get automatic analysis on crash.
+ */
+process.on("uncaughtException", (err) => {
+  // We search the stack trace because sometimes the match string 
+  // is hidden deep in the error history.
+  const errStr = err !== null && typeof err === "object" ? (err.stack || err.message) : String(err ?? "unknown error");
+  const { count, matches } = findError(errStr);
+  
+  if (count > 0) {
+    console.log(chalk.cyan.bold(`\n💡 ErrLens Runtime Analysis (${count} Issues Found):`));
+    matches.forEach(match => console.log(formatError(match)));
+  } else {
+    // If we don't know the error, show the original one so the dev isn't lost
+    console.error(chalk.red.bold("\n--- Raw System Error ---"));
+    console.error(err);
+  }
+
+  // Always exit with failure code 1 after a crash
+  process.exit(1);
+});
+
+// Also handle Unhandled Promise Rejections (Async/Await errors)
+process.on("unhandledRejection", (reason) => {
+    const reasonStr = reason !== null && typeof reason === "object" ? (reason.stack || reason.message) : String(reason ?? "unknown error");
+    const { count, matches } = findError(reasonStr);
+    
+    if (count > 0) {
+      console.log(chalk.magenta.bold(`\n📡 ErrLens Async Error Detection:`));
+      matches.forEach(match => console.log(formatError(match)));
+    } else {
+      console.error(chalk.red.bold("\n--- Unhandled Async Rejection ---"));
+      console.error(reason);
+    }
+    process.exit(1);
+});
+
+console.log(chalk.dim("🔧 ErrLens Protection Enabled."));

package/lib/matcher.js

@@ -1,25 +1,42 @@
-const Fuse = require("fuse.js");
 const database = require("./database.json");
 
 function findError(input) {
-  if (!input) return null;
-
-  // Clean the input:
-  // 1. Take only the first line (the error message).
-  // 2. Remove common noise like 'Uncaught' or file paths.
-  const coreError = input.split('\n')[0]
-    .replace(/^Uncaught\s+/, '')
-    .split(' at ')[0]
-    .trim();
-
-  const fuse = new Fuse(database, {
-    keys: ["match", "name"],
-    threshold: 0.4, // Balance between strict and loose
-    distance: 100
+  if (!input) return { count: 0, matches: [] };
+
+  if (typeof input !== "string") input = String(input);
+
+  // 1. Normalize the input (Lowercase and remove extra whitespace)
+  const lowerInput = input.toLowerCase();
+  
+  // 2. Filter the database
+  let foundMatches = database.filter(entry => {
+    const matchPhrase = entry.match.toLowerCase();
+    
+    // STRICT CHECK: The phrase must exist in the error log
+    return lowerInput.includes(matchPhrase);
   });
 
-  const result = fuse.search(coreError);
-  return result.length > 0 ? result[0].item : null;
+  // 3. SPECIFICITY SORTING (The Secret Sauce)
+  // If we find "Cannot read properties of undefined" AND "TypeError", 
+  // we want the longer, more specific one to show up first.
+  foundMatches.sort((a, b) => b.match.length - a.match.length);
+
+  // 4. DEDUPLICATION
+  // Ensure we don't show the same category twice
+  const uniqueMatches = [];
+  const seenNames = new Set();
+
+  for (const match of foundMatches) {
+    if (!seenNames.has(match.name)) {
+      uniqueMatches.push(match);
+      seenNames.add(match.name);
+    }
+  }
+
+  return {
+    count: uniqueMatches.length,
+    matches: uniqueMatches
+  };
 }
 
 module.exports = { findError };

package/package.json

@@ -1,29 +1,58 @@
 {
   "name": "errlens",
-  "version": "1.0.2",
-  "description": "A CLI tool that explains JavaScript/Node.js errors in plain English.",
+  "version": "1.0.4",
+  "description": "Professional CLI tool that explains JavaScript and Node.js errors in plain English with actionable fixes directly in your terminal.",
+  "type": "module",
   "main": "./bin/index.js",
+  "bin": {
+    "errlens": "./bin/index.js"
+  },
+  "preferGlobal": true,
   "author": "BeyteFlow (https://github.com/BeyteFlow)",
   "license": "MIT",
-  "bin": {
-    "errlens": "bin/index.js"
+  "keywords": [
+    "javascript",
+    "nodejs",
+    "cli",
+    "error",
+    "debugging",
+    "stacktrace",
+    "developer-tools",
+    "terminal",
+    "diagnostics",
+    "productivity",
+    "devtools",
+    "error-handler"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "test": "node --test test/**/*.test.js"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BeyteFlow/errlens.git"
+    "url": "https://github.com/BeyteFlow/errlens.git"
   },
   "bugs": {
     "url": "https://github.com/BeyteFlow/errlens/issues"
   },
   "homepage": "https://github.com/BeyteFlow/errlens#readme",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/BeyteFlow"
+  },
   "dependencies": {
-    "boxen": "^5.1.2",
-    "chalk": "^4.1.2",
-    "commander": "^11.1.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
     "fuse.js": "^7.0.0",
-    "ora": "^5.4.1"
+    "ora": "^9.3.0"
   }
 }