errlens 1.0.10 → 1.1.1

package/bin/index.js

@@ -2,7 +2,6 @@
 
 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/formatter.js

@@ -1,4 +1,5 @@
-const chalk = require("chalk");
+const chalkImport = require("chalk");
+const chalk = chalkImport.default || chalkImport;
 const boxen = require("boxen");
 
 function formatError(error) {

package/lib/injector.js

@@ -1,6 +1,7 @@
 const { findError } = require("./matcher");
 const { formatError } = require("./formatter");
-const chalk = require("chalk");
+const chalkImport = require("chalk");
+const chalk = chalkImport.default || chalkImport;
 
 /**
  * ERR_LENS INJECTOR

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/locales/de.json

@@ -0,0 +1,199 @@
+{
+  "Cannot read properties of undefined__explanation": "Sie versuchen, auf eine Eigenschaft einer Variable zuzugreifen, die derzeit leer ist.",
+  "Cannot read properties of undefined__why": "Die Variable wurde nicht initialisiert oder ein API-Aufruf ist noch nicht abgeschlossen.",
+  "Cannot read properties of undefined__fix_0": "Verwenden Sie Optional Chaining: user?.name",
+  "Cannot read properties of undefined__fix_1": "Setzen Sie einen Standardwert: data || []",
+  "is not defined__explanation": "Sie verwenden eine Variable, die nicht deklariert wurde.",
+  "is not defined__why": "Tippfehler im Namen oder die Variable ist innerhalb einer anderen Funktion gekapselt.",
+  "is not defined__fix_0": "Auf Tippfehler prüfen",
+  "is not defined__fix_1": "Mit const/let deklarieren",
+  "is not a function__explanation": "Sie haben eine Variable als Funktion aufgerufen, aber es ist ein anderer Typ (String/Object).",
+  "is not a function__why": "Import fehlgeschlagen oder ein Callback wurde nicht korrekt übergeben.",
+  "is not a function__fix_0": "Imports überprüfen",
+  "is not a function__fix_1": "Typ mit typeof verifizieren",
+  "Cannot find module__explanation": "Node.js kann die Datei oder das Paket, das Sie importieren, nicht finden.",
+  "Cannot find module__why": "Das Paket ist nicht installiert oder der relative Pfad ist falsch.",
+  "Cannot find module__fix_0": "Führen Sie 'npm install' aus",
+  "Cannot find module__fix_1": "Dateipfad-Schreibweise überprüfen",
+  "EADDRINUSE__explanation": "Der Port, den Ihr Server verwenden möchte, wird bereits verwendet.",
+  "EADDRINUSE__why": "Eine andere Instanz Ihrer Anwendung läuft bereits.",
+  "EADDRINUSE__fix_0": "Den anderen Prozess beenden",
+  "EADDRINUSE__fix_1": "Die Portnummer ändern",
+  "Maximum call stack size exceeded__explanation": "Die Aufrufstapel-Grenze wurde aufgrund übermäßiger Rekursion oder einer sehr tiefen Aufrufkette erreicht.",
+  "Maximum call stack size exceeded__why": "Eine rekursive Funktion ruft sich zu oft selbst auf, ohne einen Basisfall zu erreichen, oder eine Kette von Funktionsaufrufen baut sich zu tief auf.",
+  "Maximum call stack size exceeded__fix_0": "Rekursions-Abbruchbedingungen prüfen",
+  "Maximum call stack size exceeded__fix_1": "Verifizieren, dass rekursive Basisfälle erreichbar sind",
+  "Maximum call stack size exceeded__fix_2": "Aufrufketten-Tiefe und stapelbildende Schleifen überprüfen",
+  "ECONNREFUSED__explanation": "Ihre App hat versucht, sich mit einer Datenbank/API zu verbinden, wurde aber abgelehnt.",
+  "ECONNREFUSED__why": "Der Zielserver ist nicht erreichbar oder die URL ist falsch.",
+  "ECONNREFUSED__fix_0": "Stellen Sie sicher, dass die Datenbank läuft",
+  "ECONNREFUSED__fix_1": "Überprüfen Sie die API-URL",
+  "Assignment to constant variable__explanation": "Sie haben versucht, eine 'const'-Variable zu ändern.",
+  "Assignment to constant variable__why": "Const-Variablen können nicht neu zugewiesen werden.",
+  "Assignment to constant variable__fix_0": "Verwenden Sie 'let' anstelle von 'const'",
+  "ENOENT__explanation": "Sie versuchen, eine Datei zu lesen, die nicht existiert.",
+  "ENOENT__why": "Die Datei wurde verschoben oder der Pfad-String ist falsch.",
+  "ENOENT__fix_0": "Überprüfen Sie, ob die Datei existiert",
+  "ENOENT__fix_1": "Verwenden Sie path.join()",
+  "await is only valid in async functions__explanation": "Sie haben 'await' innerhalb einer normalen Funktion verwendet.",
+  "await is only valid in async functions__why": "Await erfordert das Schlüsselwort 'async' bei der übergeordneten Funktion.",
+  "await is only valid in async functions__fix_0": "Fügen Sie 'async' zur Funktionsdefinition hinzu",
+  "ERR_HTTP_HEADERS_SENT__explanation": "Sie haben eine Antwort gesendet, nachdem bereits eine gesendet wurde.",
+  "ERR_HTTP_HEADERS_SENT__why": "Mehrere res.send()-Aufrufe in einer Route.",
+  "ERR_HTTP_HEADERS_SENT__fix_0": "Verwenden Sie 'return res.send()', um die Ausführung zu stoppen",
+  "buffering timed out__explanation": "Mongoose konnte sich nicht rechtzeitig mit MongoDB verbinden.",
+  "buffering timed out__why": "Die Datenbank ist offline oder die Verbindungszeichenkette ist falsch.",
+  "buffering timed out__fix_0": "Überprüfen Sie den MongoDB-Status",
+  "buffering timed out__fix_1": "Überprüfen Sie die Verbindungszeichenkette",
+  "jwt malformed__explanation": "Der bereitgestellte Token hat keine gültige JWT-Struktur.",
+  "jwt malformed__why": "Der Token ist beschädigt oder es wurde nur ein Teil davon gesendet.",
+  "jwt malformed__fix_0": "Überprüfen Sie den 'Authorization'-Header",
+  "jwt malformed__fix_1": "Überprüfen Sie die Token-Generierung",
+  "secretOrPrivateKey must have a value__explanation": "JWT-Geheimschlüssel fehlt.",
+  "secretOrPrivateKey must have a value__why": "Umgebungsvariable (JWT_SECRET) ist nicht geladen.",
+  "secretOrPrivateKey must have a value__fix_0": ".env-Datei prüfen",
+  "secretOrPrivateKey must have a value__fix_1": "dotenv.config() ausführen",
+  "E11000__explanation": "Sie versuchen, Daten mit einem 'unique'-Feld zu speichern, das bereits existiert.",
+  "E11000__why": "Meist eine doppelte E-Mail oder Benutzername in der DB.",
+  "E11000__fix_0": "Prüfen, ob Daten existieren, bevor gespeichert wird",
+  "E11000__fix_1": "Eindeutige Fehlerbehandlung verwenden",
+  "Unexpected token < in JSON__explanation": "Sie haben versucht, JSON zu parsen, aber stattdessen HTML erhalten.",
+  "Unexpected token < in JSON__why": "Ihre API hat eine Fehlerseite (HTML) statt Daten (JSON) zurückgegeben.",
+  "Unexpected token < in JSON__fix_0": "API-URL prüfen",
+  "Unexpected token < in JSON__fix_1": "Server-Logs auf Abstürze prüfen",
+  "CORS__explanation": "Browser hat Ihre Anfrage aus Sicherheitsgründen blockiert.",
+  "CORS__why": "Der Server erlaubt keine Anfragen von Ihrer Frontend-Domain.",
+  "CORS__fix_0": "'cors'-Paket auf dem Server installieren",
+  "CORS__fix_1": "app.use(cors())",
+  "'map' of undefined__explanation": "Sie versuchen, durch ein Array zu iterieren, das nicht existiert.",
+  "'map' of undefined__why": "Die Variable ist null/undefined statt einem Array.",
+  "'map' of undefined__fix_0": "Als leeres Array initialisieren: data || []",
+  "'map' of undefined__fix_1": "API-Antwort prüfen",
+  "module not found 'dotenv'__explanation": "Das 'dotenv'-Paket fehlt.",
+  "module not found 'dotenv'__why": "Sie haben es im Code verwendet, aber nicht installiert.",
+  "module not found 'dotenv'__fix_0": "npm install dotenv",
+  "validation failed__explanation": "Daten stimmen nicht mit Ihrem Mongoose-Schema überein.",
+  "validation failed__why": "Pflichtfelder fehlen oder falsche Datentypen.",
+  "validation failed__fix_0": "Pflichtfelder überprüfen",
+  "validation failed__fix_1": "Daten im Frontend validieren",
+  "not authorized__explanation": "Zugriff verweigert aufgrund fehlender oder ungültiger Anmeldedaten.",
+  "not authorized__why": "Token abgelaufen oder falscher API-Schlüssel.",
+  "not authorized__fix_0": "Erneut anmelden",
+  "not authorized__fix_1": "Header überprüfen",
+  "status code 404__explanation": "Der API-Endpunkt, den Sie aufrufen, existiert nicht.",
+  "status code 404__why": "Falsche URL oder die Server-Route ist nicht definiert.",
+  "status code 404__fix_0": "Schreibweise der API-Route überprüfen",
+  "status code 404__fix_1": "Basis-URL überprüfen",
+  "status code 500__explanation": "Der Server ist beim Verarbeiten Ihrer Anfrage abgestürzt.",
+  "status code 500__why": "Ein Fehler im Backend-Server-Code.",
+  "status code 500__fix_0": "Server-Konsolenprotokolle überprüfen",
+  "status code 500__fix_1": "Try/Catch auf dem Server hinzufügen",
+  "is not iterable__explanation": "Sie haben eine for...of-Schleife oder Spread (...) auf einem Nicht-Array verwendet.",
+  "is not iterable__why": "Sie haben versucht, über ein Objekt oder Null zu iterieren.",
+  "is not iterable__fix_0": "Sicherstellen, dass die Variable ein Array ist",
+  "is not iterable__fix_1": "Object.keys() verwenden",
+  "require is not defined__explanation": "Sie verwenden 'require' in einem ES-Modul.",
+  "require is not defined__why": "Node.js ist in package.json auf 'type': 'module' eingestellt.",
+  "require is not defined__fix_0": "Stattdessen 'import' verwenden",
+  "require is not defined__fix_1": "'type: module' entfernen",
+  "EACCES__explanation": "Sie haben keine Berechtigung, auf diese Datei/diesen Port zuzugreifen.",
+  "EACCES__why": "Sie benötigen Administratorrechte oder die Datei ist gesperrt.",
+  "EACCES__fix_0": "'sudo' verwenden (Linux/Mac)",
+  "EACCES__fix_1": "Dateiberechtigungen überprüfen",
+  "has already been declared__explanation": "Sie haben denselben Variablennamen zweimal deklariert.",
+  "has already been declared__why": "Verwendung von 'let' oder 'const' für einen Namen, der bereits im selben Gültigkeitsbereich existiert.",
+  "has already been declared__fix_0": "Eine der Variablen umbenennen",
+  "has already been declared__fix_1": "Die zweite Deklaration entfernen",
+  "PayloadTooLargeError__explanation": "Die von Ihnen gesendeten Daten sind zu groß für den Server.",
+  "PayloadTooLargeError__why": "Normalerweise ein Bild oder eine Datei, die das Body-Parser-Limit überschreitet.",
+  "PayloadTooLargeError__fix_0": "Limit erhöhen: app.use(express.json({limit: '50mb'}))",
+  "set property of null__explanation": "Sie versuchen, einer Eigenschaft einer leeren Variable einen Wert zuzuweisen.",
+  "set property of null__why": "Das Objekt, das Sie ändern möchten, wurde noch nicht erstellt.",
+  "set property of null__fix_0": "Das Objekt zuerst initialisieren",
+  "set property of null__fix_1": "Auf null prüfen",
+  "socket hang up__explanation": "Der Server hat die Verbindung unerwartet geschlossen.",
+  "socket hang up__why": "Server abgestürzt oder Zeitüberschreitung aufgetreten.",
+  "socket hang up__fix_0": "Server-Status überprüfen",
+  "socket hang up__fix_1": "Zeitlimit erhöhen",
+  "Unexpected end of JSON input__explanation": "Die JSON-Daten sind unvollständig oder leer.",
+  "Unexpected end of JSON input__why": "Der Server hat eine leere Zeichenfolge anstelle von JSON gesendet.",
+  "Unexpected end of JSON input__fix_0": "API-Antwort überprüfen",
+  "Unexpected end of JSON input__fix_1": "Leere Antworten behandeln",
+  "Script execution timed out__explanation": "Ihr Code hat zu lange für die Ausführung gebraucht.",
+  "Script execution timed out__why": "Aufwändige Berechnung oder Endlosschleife.",
+  "Script execution timed out__fix_0": "Logik optimieren",
+  "Script execution timed out__fix_1": "Worker-Threads verwenden",
+  "'then' of undefined__explanation": "Sie haben .then() auf etwas aufgerufen, das kein Promise ist.",
+  "'then' of undefined__why": "Die Funktion hat kein Promise zurückgegeben.",
+  "'then' of undefined__fix_0": "Funktion 'async' machen",
+  "'then' of undefined__fix_1": "Promise zurückgeben",
+  "Invalid connection string__explanation": "Das Format der Datenbank-URL ist falsch.",
+  "Invalid connection string__why": "Fehlende Symbole wie '@' oder '/' in der URI.",
+  "Invalid connection string__fix_0": "DB-URI-Format prüfen",
+  "window is not defined__explanation": "Sie versuchen, Browser-Code (window) in Node.js zu verwenden.",
+  "window is not defined__why": "Node.js hat kein 'window'-Objekt (das ist für Browser).",
+  "window is not defined__fix_0": "Prüfen, ob im Browser ausgeführt",
+  "window is not defined__fix_1": "Stattdessen 'global' verwenden",
+  "Too many listeners__explanation": "Speicherleck bei EventEmitters erkannt.",
+  "Too many listeners__why": "Event-Listener werden innerhalb einer Schleife oder wiederholten Funktion hinzugefügt.",
+  "Too many listeners__fix_0": ".once() statt .on() verwenden",
+  "Too many listeners__fix_1": "Alte Listener entfernen",
+  "spread non-iterable__explanation": "Sie haben versucht, `...obj` zu verwenden, wo es nicht erlaubt ist.",
+  "spread non-iterable__why": "Versuch, ein Objekt in ein Array zu spreaden.",
+  "spread non-iterable__fix_0": "Eckige Klammern [] für Arrays und {} für Objekte verwenden",
+  "EPIPE__explanation": "Broken Pipe: Daten werden an eine geschlossene Verbindung gesendet.",
+  "EPIPE__why": "Die Gegenseite (Client/Prozess) hört nicht mehr zu.",
+  "EPIPE__fix_0": "Stream-Fehler behandeln",
+  "EPIPE__fix_1": "Prüfen, ob Prozess aktiv ist",
+  "Missing initializer__explanation": "Sie haben eine Konstante ohne Wertzuweisung deklariert.",
+  "Missing initializer__why": "Const muss sofort bei der Erstellung gesetzt werden.",
+  "Missing initializer__fix_0": "Wert zuweisen: const x = 1;",
+  "peerinvalid__explanation": "Installierte Pakete haben widersprüchliche Versionen.",
+  "peerinvalid__why": "Eine Bibliothek benötigt Version A, eine andere benötigt Version B.",
+  "peerinvalid__fix_0": "npm install --legacy-peer-deps",
+  "filter is not a function__explanation": "Sie versuchen, etwas zu filtern, das kein Array ist.",
+  "filter is not a function__why": "Die Variable ist ein Objekt oder Null.",
+  "filter is not a function__fix_0": "Stellen Sie sicher, dass data ein Array ist: Array.isArray(data)",
+  "ENOTFOUND__explanation": "DNS-Auflösung für die URL fehlgeschlagen.",
+  "ENOTFOUND__why": "Tippfehler in der URL oder keine Internetverbindung.",
+  "ENOTFOUND__fix_0": "URL-Schreibweise überprüfen",
+  "ENOTFOUND__fix_1": "DNS/Internet überprüfen",
+  "reserved word__explanation": "Sie haben ein für JS reserviertes Wort (wie 'class' oder 'await') als Variablennamen verwendet.",
+  "reserved word__why": "Sie können eine Variable nicht 'class' oder 'function' nennen.",
+  "reserved word__fix_0": "Variable umbenennen",
+  "Cannot find name__explanation": "TypeScript kann diese Variable oder diesen Typ nicht finden.",
+  "Cannot find name__why": "Variable nicht deklariert oder @types-Paket fehlt.",
+  "Cannot find name__fix_0": "Imports überprüfen",
+  "Cannot find name__fix_1": "Typen installieren: npm install @types/node",
+  "convert undefined or null to object__explanation": "Object-Methoden werden auf eine leere Variable angewendet.",
+  "convert undefined or null to object__why": "Object.keys(data) wird verwendet, wenn data null ist.",
+  "convert undefined or null to object__fix_0": "Überprüfen Sie, ob data existiert: data && Object.keys(data)",
+  "Access-Control-Allow-Origin__explanation": "CORS-Fehler: Der Server teilt keine Daten mit Ihrer Domain.",
+  "Access-Control-Allow-Origin__why": "Sicherheitsrichtlinie im Backend.",
+  "Access-Control-Allow-Origin__fix_0": "CORS serverseitig aktivieren",
+  "Invalid or unexpected token__explanation": "Es befindet sich ein Zeichen in Ihrem Code, das dort nicht sein sollte.",
+  "Invalid or unexpected token__why": "Beim Kopieren und Einfügen werden versteckte Symbole übertragen oder typografische Anführungszeichen („ statt \") verwendet.",
+  "Invalid or unexpected token__fix_0": "Zeile manuell neu eingeben",
+  "Invalid or unexpected token__fix_1": "Prüfe auf unsichtbare Zeichen",
+  "timeout of 2000ms exceeded__explanation": "Dein Test hat zu lange gebraucht, um abzuschließen.",
+  "timeout of 2000ms exceeded__why": "Asynchroner Code hat 'done()' nicht aufgerufen oder wurde nicht rechtzeitig beendet.",
+  "timeout of 2000ms exceeded__fix_0": "Erhöhe das Test-Timeout",
+  "timeout of 2000ms exceeded__fix_1": "Prüfe auf langsame API-Aufrufe",
+  "does not exist on type__explanation": "TypeScript-Fehler: Zugriff auf eine Eigenschaft, die nicht im Interface vorhanden ist.",
+  "does not exist on type__why": "Die Objektstruktur stimmt nicht mit der TypeScript-Typdefinition überein.",
+  "does not exist on type__fix_0": "Aktualisiere das Interface",
+  "does not exist on type__fix_1": "Verwende Type Casting: (obj as any).prop",
+  "npm ERR! 404__explanation": "NPM kann das Paket, das du installieren möchtest, nicht finden.",
+  "npm ERR! 404__why": "Tippfehler im Paketnamen oder es ist ein privates Paket.",
+  "npm ERR! 404__fix_0": "Prüfe die Schreibweise des Pakets",
+  "npm ERR! 404__fix_1": "npm login",
+  "Unexpected end of input__explanation": "Ihr Code wurde abrupt beendet, wahrscheinlich fehlt eine schließende Klammer.",
+  "Unexpected end of input__why": "Sie haben eine ( [ oder { geöffnet, aber vergessen, sie mit ) ] oder } zu schließen.",
+  "Unexpected end of input__fix_0": "Prüfen Sie auf fehlende schließende Klammern )",
+  "Unexpected end of input__fix_1": "Prüfen Sie auf fehlende geschweifte Klammern }",
+  "Unexpected end of input__fix_2": "Stelle sicher, dass alle Anführungszeichen ' oder \" geschlossen sind",
+  "missing ) after argument list__explanation": "Sie haben vergessen, einen Funktionsaufruf mit ')' zu schließen.",
+  "missing ) after argument list__why": "Eine Klammer wurde geöffnet, aber die Zeile endete oder ein anderes Symbol erschien, bevor sie geschlossen wurde.",
+  "missing ) after argument list__fix_0": "Fügen Sie eine ')' am Ende Ihres Funktionsaufrufs hinzu",
+  "missing ) after argument list__fix_1": "Prüfen Sie, ob Sie versehentlich eine ')' beim Tippen gelöscht haben"
+}

package/locales/en.json

@@ -0,0 +1,199 @@
+{
+  "Cannot read properties of undefined__explanation": "You are trying to access a property on a variable that is currently empty.",
+  "Cannot read properties of undefined__why": "The variable wasn't initialized, or an API call hasn't finished yet.",
+  "Cannot read properties of undefined__fix_0": "Use optional chaining: user?.name",
+  "Cannot read properties of undefined__fix_1": "Set a default value: data || []",
+  "is not defined__explanation": "You're using a variable that hasn't been declared.",
+  "is not defined__why": "Typo in the name or the variable is scoped inside another function.",
+  "is not defined__fix_0": "Check for typos",
+  "is not defined__fix_1": "Declare with const/let",
+  "is not a function__explanation": "You called a variable as a function, but it's another type (String/Object).",
+  "is not a function__why": "Import failed or a callback wasn't passed correctly.",
+  "is not a function__fix_0": "Check imports",
+  "is not a function__fix_1": "Verify type with typeof",
+  "Cannot find module__explanation": "Node.js cannot find the file or package you are importing.",
+  "Cannot find module__why": "The package isn't installed or the relative path is wrong.",
+  "Cannot find module__fix_0": "Run 'npm install'",
+  "Cannot find module__fix_1": "Check file path spelling",
+  "EADDRINUSE__explanation": "The port your server wants is already being used.",
+  "EADDRINUSE__why": "Another instance of your app is already running.",
+  "EADDRINUSE__fix_0": "Kill the other process",
+  "EADDRINUSE__fix_1": "Change the port number",
+  "Maximum call stack size exceeded__explanation": "The call stack limit was reached due to excessive recursion or a very deep call chain.",
+  "Maximum call stack size exceeded__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.",
+  "Maximum call stack size exceeded__fix_0": "Check recursion exit conditions",
+  "Maximum call stack size exceeded__fix_1": "Verify recursive base cases are reachable",
+  "Maximum call stack size exceeded__fix_2": "Check call-chain depth and stack-building loops",
+  "ECONNREFUSED__explanation": "Your app tried to connect to a database/API but was rejected.",
+  "ECONNREFUSED__why": "The target server is down or the URL is wrong.",
+  "ECONNREFUSED__fix_0": "Ensure DB is running",
+  "ECONNREFUSED__fix_1": "Check API URL",
+  "Assignment to constant variable__explanation": "You tried to change a 'const' variable.",
+  "Assignment to constant variable__why": "Const variables cannot be reassigned.",
+  "Assignment to constant variable__fix_0": "Use 'let' instead of 'const'",
+  "ENOENT__explanation": "You're trying to read a file that doesn't exist.",
+  "ENOENT__why": "File moved or path string is incorrect.",
+  "ENOENT__fix_0": "Verify file exists",
+  "ENOENT__fix_1": "Use path.join()",
+  "await is only valid in async functions__explanation": "You used 'await' inside a normal function.",
+  "await is only valid in async functions__why": "Await requires the 'async' keyword on the parent function.",
+  "await is only valid in async functions__fix_0": "Add 'async' to function definition",
+  "ERR_HTTP_HEADERS_SENT__explanation": "You sent a response after already sending one.",
+  "ERR_HTTP_HEADERS_SENT__why": "Multiple res.send() calls in one route.",
+  "ERR_HTTP_HEADERS_SENT__fix_0": "Use 'return res.send()' to stop execution",
+  "buffering timed out__explanation": "Mongoose couldn't connect to MongoDB in time.",
+  "buffering timed out__why": "Database is offline or connection string is wrong.",
+  "buffering timed out__fix_0": "Check MongoDB status",
+  "buffering timed out__fix_1": "Check connection string",
+  "jwt malformed__explanation": "The token provided is not a valid JWT structure.",
+  "jwt malformed__why": "Token is corrupted or only part of it was sent.",
+  "jwt malformed__fix_0": "Check 'Authorization' header",
+  "jwt malformed__fix_1": "Verify token generation",
+  "secretOrPrivateKey must have a value__explanation": "JWT secret key is missing.",
+  "secretOrPrivateKey must have a value__why": "Environment variable (JWT_SECRET) is not loaded.",
+  "secretOrPrivateKey must have a value__fix_0": "Check .env file",
+  "secretOrPrivateKey must have a value__fix_1": "Run dotenv.config()",
+  "E11000__explanation": "You're saving data with a 'unique' field that already exists.",
+  "E11000__why": "Usually a duplicate Email or Username in the DB.",
+  "E11000__fix_0": "Check if data exists before saving",
+  "E11000__fix_1": "Use unique error handling",
+  "Unexpected token < in JSON__explanation": "You tried to parse JSON, but got HTML instead.",
+  "Unexpected token < in JSON__why": "Your API returned an error page (HTML) instead of data (JSON).",
+  "Unexpected token < in JSON__fix_0": "Check the API URL",
+  "Unexpected token < in JSON__fix_1": "Check server logs for crashes",
+  "CORS__explanation": "Browser blocked your request for security reasons.",
+  "CORS__why": "The server doesn't allow requests from your frontend domain.",
+  "CORS__fix_0": "Install 'cors' package on server",
+  "CORS__fix_1": "app.use(cors())",
+  "'map' of undefined__explanation": "You're trying to loop through an array that doesn't exist.",
+  "'map' of undefined__why": "The variable is null/undefined instead of an Array.",
+  "'map' of undefined__fix_0": "Initialize as empty array: data || []",
+  "'map' of undefined__fix_1": "Check API response",
+  "module not found 'dotenv'__explanation": "The 'dotenv' package is missing.",
+  "module not found 'dotenv'__why": "You used it in code but didn't install it.",
+  "module not found 'dotenv'__fix_0": "npm install dotenv",
+  "validation failed__explanation": "Data doesn't match your Mongoose schema.",
+  "validation failed__why": "Missing required fields or wrong data types.",
+  "validation failed__fix_0": "Check required fields",
+  "validation failed__fix_1": "Validate data on frontend",
+  "not authorized__explanation": "Access denied because of missing or invalid credentials.",
+  "not authorized__why": "Token expired or wrong API key.",
+  "not authorized__fix_0": "Login again",
+  "not authorized__fix_1": "Check headers",
+  "status code 404__explanation": "The API endpoint you are calling doesn't exist.",
+  "status code 404__why": "Wrong URL or the server route isn't defined.",
+  "status code 404__fix_0": "Check API route spelling",
+  "status code 404__fix_1": "Check Base URL",
+  "status code 500__explanation": "The server crashed while processing your request.",
+  "status code 500__why": "A bug on the backend server code.",
+  "status code 500__fix_0": "Check server console logs",
+  "status code 500__fix_1": "Add try/catch on server",
+  "is not iterable__explanation": "You used a for...of loop or spread (...) on a non-array.",
+  "is not iterable__why": "You tried to iterate over an Object or Null.",
+  "is not iterable__fix_0": "Ensure variable is an Array",
+  "is not iterable__fix_1": "Use Object.keys()",
+  "require is not defined__explanation": "You're using 'require' in an ES Module.",
+  "require is not defined__why": "Node.js is set to 'type': 'module' in package.json.",
+  "require is not defined__fix_0": "Use 'import' instead",
+  "require is not defined__fix_1": "Remove 'type: module'",
+  "EACCES__explanation": "You don't have permission to access this file/port.",
+  "EACCES__why": "You need admin rights or the file is locked.",
+  "EACCES__fix_0": "Use 'sudo' (Linux/Mac)",
+  "EACCES__fix_1": "Check file permissions",
+  "has already been declared__explanation": "You declared the same variable name twice.",
+  "has already been declared__why": "Using 'let' or 'const' on a name that exists in the same scope.",
+  "has already been declared__fix_0": "Rename one of the variables",
+  "has already been declared__fix_1": "Remove the second declaration",
+  "PayloadTooLargeError__explanation": "The data you sent is too big for the server.",
+  "PayloadTooLargeError__why": "Usually an image or file that exceeds the body-parser limit.",
+  "PayloadTooLargeError__fix_0": "Increase limit: app.use(express.json({limit: '50mb'}))",
+  "set property of null__explanation": "You're trying to give a value to a property of an empty variable.",
+  "set property of null__why": "The object you're modifying hasn't been created yet.",
+  "set property of null__fix_0": "Initialize the object first",
+  "set property of null__fix_1": "Check for null",
+  "socket hang up__explanation": "The server closed the connection unexpectedly.",
+  "socket hang up__why": "Server crashed or timeout occurred.",
+  "socket hang up__fix_0": "Check server health",
+  "socket hang up__fix_1": "Increase timeout limit",
+  "Unexpected end of JSON input__explanation": "The JSON data is incomplete or empty.",
+  "Unexpected end of JSON input__why": "The server sent an empty string instead of JSON.",
+  "Unexpected end of JSON input__fix_0": "Check API response body",
+  "Unexpected end of JSON input__fix_1": "Handle empty responses",
+  "Script execution timed out__explanation": "Your code took too long to run.",
+  "Script execution timed out__why": "Heavy computation or infinite loop.",
+  "Script execution timed out__fix_0": "Optimize logic",
+  "Script execution timed out__fix_1": "Use worker threads",
+  "'then' of undefined__explanation": "You called .then() on something that isn't a Promise.",
+  "'then' of undefined__why": "The function didn't return a promise.",
+  "'then' of undefined__fix_0": "Make function 'async'",
+  "'then' of undefined__fix_1": "Return a Promise",
+  "Invalid connection string__explanation": "The database URL format is wrong.",
+  "Invalid connection string__why": "Missing symbols like '@' or '/' in the URI.",
+  "Invalid connection string__fix_0": "Check DB URI format",
+  "window is not defined__explanation": "You're trying to use browser code (window) in Node.js.",
+  "window is not defined__why": "Node.js doesn't have a 'window' object (that's for browsers).",
+  "window is not defined__fix_0": "Check if running in browser",
+  "window is not defined__fix_1": "Use 'global' instead",
+  "Too many listeners__explanation": "Memory leak detected in EventEmitters.",
+  "Too many listeners__why": "Adding event listeners inside a loop or repeated function.",
+  "Too many listeners__fix_0": "Use .once() instead of .on()",
+  "Too many listeners__fix_1": "Remove old listeners",
+  "spread non-iterable__explanation": "You tried to use `...obj` where it's not allowed.",
+  "spread non-iterable__why": "Trying to spread an object into an array.",
+  "spread non-iterable__fix_0": "Use brackets [] for arrays and {} for objects",
+  "EPIPE__explanation": "Broken pipe: sending data to a closed connection.",
+  "EPIPE__why": "The other side (client/process) stopped listening.",
+  "EPIPE__fix_0": "Handle stream errors",
+  "EPIPE__fix_1": "Check if process is alive",
+  "Missing initializer__explanation": "You declared a const without giving it a value.",
+  "Missing initializer__why": "Const must be set immediately when created.",
+  "Missing initializer__fix_0": "Assign a value: const x = 1;",
+  "peerinvalid__explanation": "Installed packages have conflicting versions.",
+  "peerinvalid__why": "One library needs version A, another needs version B.",
+  "peerinvalid__fix_0": "npm install --legacy-peer-deps",
+  "filter is not a function__explanation": "You're trying to filter something that isn't an array.",
+  "filter is not a function__why": "The variable is an Object or Null.",
+  "filter is not a function__fix_0": "Ensure data is an Array: Array.isArray(data)",
+  "ENOTFOUND__explanation": "DNS lookup failed for the URL.",
+  "ENOTFOUND__why": "Typo in the URL or no internet connection.",
+  "ENOTFOUND__fix_0": "Check URL spelling",
+  "ENOTFOUND__fix_1": "Check DNS/Internet",
+  "reserved word__explanation": "You used a word saved for JS (like 'class' or 'await') as a variable name.",
+  "reserved word__why": "You can't name a variable 'class' or 'function'.",
+  "reserved word__fix_0": "Rename the variable",
+  "Cannot find name__explanation": "TypeScript cannot find this variable or type.",
+  "Cannot find name__why": "Variable not declared or missing @types package.",
+  "Cannot find name__fix_0": "Check imports",
+  "Cannot find name__fix_1": "Install types: npm install @types/node",
+  "convert undefined or null to object__explanation": "Calling Object methods on an empty variable.",
+  "convert undefined or null to object__why": "Using Object.keys(data) when data is null.",
+  "convert undefined or null to object__fix_0": "Check if data exists: data && Object.keys(data)",
+  "Access-Control-Allow-Origin__explanation": "CORS error: Server isn't sharing data with your domain.",
+  "Access-Control-Allow-Origin__why": "Security policy on the backend.",
+  "Access-Control-Allow-Origin__fix_0": "Enable CORS on the server side",
+  "Invalid or unexpected token__explanation": "There is a character in your code that shouldn't be there.",
+  "Invalid or unexpected token__why": "Copy-pasting hidden symbols or using smart quotes (” instead of \").",
+  "Invalid or unexpected token__fix_0": "Retype the line manually",
+  "Invalid or unexpected token__fix_1": "Check for invisible symbols",
+  "timeout of 2000ms exceeded__explanation": "Your test took too long to finish.",
+  "timeout of 2000ms exceeded__why": "Asynchronous code didn't call 'done()' or finish in time.",
+  "timeout of 2000ms exceeded__fix_0": "Increase test timeout",
+  "timeout of 2000ms exceeded__fix_1": "Check for slow API calls",
+  "does not exist on type__explanation": "TypeScript Error: Accessing a property that isn't in the Interface.",
+  "does not exist on type__why": "The object structure doesn't match the TS Type definition.",
+  "does not exist on type__fix_0": "Update the Interface",
+  "does not exist on type__fix_1": "Use type casting: (obj as any).prop",
+  "npm ERR! 404__explanation": "NPM can't find the package you want to install.",
+  "npm ERR! 404__why": "Typo in the package name or it's a private package.",
+  "npm ERR! 404__fix_0": "Check package spelling",
+  "npm ERR! 404__fix_1": "npm login",
+  "Unexpected end of input__explanation": "Your code stopped abruptly, likely due to a missing closing bracket.",
+  "Unexpected end of input__why": "You opened a ( [ or { but forgot to close it with ) ] or }.",
+  "Unexpected end of input__fix_0": "Check for missing closing parentheses )",
+  "Unexpected end of input__fix_1": "Check for missing curly braces }",
+  "Unexpected end of input__fix_2": "Ensure all quotes ' or \" are closed",
+  "missing ) after argument list__explanation": "You forgot to close a function call with a ')'.",
+  "missing ) after argument list__why": "A parenthesis was opened but the line ended or another symbol appeared before it was closed.",
+  "missing ) after argument list__fix_0": "Add a ')' at the end of your function call",
+  "missing ) after argument list__fix_1": "Check if you accidentally deleted a ')' while typing"
+}