errlens 1.0.9 → 1.1.0

package/bin/index.js

@@ -1,8 +1,7 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const { Command } = require("commander");
 const { spawn } = require("child_process");
-const chalk = require("chalk");
 const path = require("path");
 const { findError } = require("../lib/matcher");
 const { formatError } = require("../lib/formatter");
@@ -20,9 +19,12 @@ program
 program
   .command("run <file>")
   .description("Run a Javascript file and analyze crashes")
-  .action(async (file) => {
-    const { default: ora } = await import("ora");
+  .option("--lang <code>", "output language (e.g. hi, es, fr)", "en")
 
+  .action(async (file,options) => {
+    const { default: ora } = await import("ora");
+    const { default: chalk } = await import("chalk");
+   
     const isJson = Boolean(program.opts().json);
     const filePath = path.resolve(process.cwd(), file);
     const spinner = isJson
@@ -58,7 +60,7 @@ program
         spinner.stop();
       }
 
-      const { count, matches } = findError(errorOutput);
+      const { count, matches } = findError(errorOutput,options.lang);
 
       // Process killed by signal
       if (code === null) {
@@ -107,6 +109,7 @@ program
       if (isJson) {
         console.log(JSON.stringify(result, null, 2));
       } else {
+        if (spinner) spinner.stop();
         console.log(chalk.red(`System Error: ${err.message}`));
       }
 
@@ -115,35 +118,32 @@ program
   });
 
 // ----------------- ANALYZE COMMAND -----------------
-program
+  program
   .command("analyze <errorString>")
   .description("Analyze a specific error string")
-  .action((errorString) => {
+  .option("--lang <code>", "output language (e.g. hi, es, fr)", "en")
+  .action(async (errorString, options) => {
+    const { default: chalk } = await import("chalk");
     const isJson = Boolean(program.opts().json);
-    const { count, matches } = findError(errorString);
+    const { count, matches } = findError(errorString, options.lang);
     const exitCode = count > 0 ? 1 : 0;
 
     if (isJson) {
-      console.log(
-        JSON.stringify({ code: exitCode, count, matches }, null, 2)
-      );
+      console.log(JSON.stringify({ code: exitCode, count, matches }, null, 2));
       process.exit(exitCode);
     }
 
     if (count > 0) {
-      console.log(
-        chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`)
-      );
+      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.red.bold("\n❌ Crash detected (No known fix in database):"));
       console.log(chalk.gray(errorString));
     }
 
     process.exit(exitCode);
   });
+  
 
 // ----------------- PARSE -----------------
 program.parse(process.argv);

package/lib/matcher.js

@@ -1,13 +1,62 @@
 const database = require("./database.json");
+const fs = require('fs')
+const path = require("path");
 
-function findError(input) {
+// Loading the locale file 
+function loadLocale(lang = "en"){
+  const localesDir = path.resolve(__dirname, "../locales");
+  const normalizedLang =
+    typeof lang === "string" && /^[a-zA-Z0-9_-]+$/.test(lang)
+      ? lang
+      : "en";
+  const filepath = path.resolve(localesDir, `${normalizedLang}.json`);
+  const fallback = path.resolve(localesDir, "en.json");
+  const relativeToLocales = path.relative(localesDir, filepath);
+  const safeFilepath =
+    !relativeToLocales.startsWith("..") && !path.isAbsolute(relativeToLocales)
+      ? filepath
+      : fallback;
+
+  try {
+    return JSON.parse(fs.readFileSync(safeFilepath,"utf8"))
+  } catch (primaryError) {
+    try {
+      return JSON.parse(fs.readFileSync(fallback,"utf8"))
+    } catch (fallbackError) {
+      throw new Error(
+        `Failed to load locale \"${normalizedLang}\" at \"${safeFilepath}\" and fallback \"${fallback}\". Primary error: ${primaryError.message}. Fallback error: ${fallbackError.message}`
+      )
+    }
+  }
+}
+
+//this function will translate every single entry using the loaded locals
+function translateEntry(entry,locale){
+  const key = entry.match
+  return{
+    ...entry,
+    explanation:locale[`${key}__explanation`] || entry.explanation,
+    why: locale[`${key}__why`] || entry.why,
+    fixes: (Array.isArray(entry.fixes) ? entry.fixes : []).map(
+      (fix,i) =>locale[`${key}__fix_${i}`] || fix
+    )
+  }
+}
+
+
+function findError(input,lang = "en") {
+  
   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();
-  
+
+
+  const locale = loadLocale(lang) // I'm calling the load local file here
+ 
+  //untouched
   // 2. Filter the database
   let foundMatches = database.filter(entry => {
     const matchPhrase = entry.match.toLowerCase();
@@ -28,7 +77,7 @@ function findError(input) {
 
   for (const match of foundMatches) {
     if (!seenNames.has(match.name)) {
-      uniqueMatches.push(match);
+      uniqueMatches.push(translateEntry(match,locale));
       seenNames.add(match.name);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "errlens",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Professional CLI tool that explains JavaScript and Node.js errors in plain English with actionable fixes directly in your terminal.",
   "main": "./bin/index.js",
   "bin": {
@@ -32,7 +32,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test test/**/*.test.js"
+    "test": "node --test test/**/*.test-lang.js"
   },
   "repository": {
     "type": "git",
@@ -48,9 +48,12 @@
   },
   "dependencies": {
     "boxen": "^5.1.2",
-    "chalk": "^5.6.2",
+    "chalk": "^4.1.2",
     "commander": "^14.0.3",
     "fuse.js": "^7.0.0",
     "ora": "^9.3.0"
+  },
+  "directories": {
+    "lib": "lib"
   }
 }