intellerror 1.0.0

package/dist/register.cjs

@@ -0,0 +1,148 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/formatter/index.ts
+var import_chalk = __toESM(require("chalk"), 1);
+
+// src/parser/index.ts
+var stackTraceParser = __toESM(require("stacktrace-parser"), 1);
+function parseStack(error) {
+  if (!error.stack) return [];
+  const parsed = stackTraceParser.parse(error.stack);
+  return parsed.map((frame) => {
+    const file = frame.file || "";
+    const isNodeInternal = file.startsWith("node:") || file.startsWith("internal/") || !file.includes("/") && !file.includes("\\");
+    const isNodeModule = file.includes("node_modules");
+    return {
+      file: frame.file,
+      methodName: frame.methodName || "<unknown>",
+      lineNumber: frame.lineNumber,
+      column: frame.column,
+      isNodeInternal: Boolean(isNodeInternal),
+      isNodeModule: Boolean(isNodeModule)
+    };
+  });
+}
+
+// src/suggestions/rules.ts
+var rules = [
+  {
+    match: (err) => err.message.includes("Cannot read properties of undefined (reading '") || err.message.includes("is not defined"),
+    message: "Accessing property on undefined/not defined object.",
+    fix: "User optional chaining like 'obj?.prop' or ensure the object is initialized.",
+    description: "You are trying to read a property from a variable that currently holds an undefined value."
+  },
+  {
+    match: (err) => err instanceof SyntaxError && err.message.includes("Unexpected token"),
+    message: "JSON Parsing or Code Syntax error.",
+    fix: "Check your JSON string for trailing commas, proper quotes, or syntax issues in your code.",
+    description: "The engine encountered something it didn't expect while parsing."
+  },
+  {
+    match: (err) => err.message.includes("is not a function"),
+    message: "Attempted to call a non-function value.",
+    fix: "Ensure that you're calling a property that is actually a function.",
+    description: "You probably tried to execute something that is a string, number, or object as if it were a function."
+  }
+];
+
+// src/suggestions/index.ts
+function getSuggestions(error) {
+  return rules.filter((rule) => rule.match(error));
+}
+
+// src/formatter/index.ts
+function formatError(error) {
+  if (!(error instanceof Error)) {
+    return String(error);
+  }
+  const stackFrames = parseStack(error);
+  const userFrame = stackFrames.find((frame) => !frame.isNodeInternal && !frame.isNodeModule);
+  const errorType = error.constructor.name || "Error";
+  const typeLabel = import_chalk.default.bgRed.white(` ${errorType} `);
+  let output = `
+${typeLabel} ${import_chalk.default.red(error.message)}
+
+`;
+  if (userFrame && userFrame.file) {
+    output += `${import_chalk.default.bold("\u{1F4CD} Location:")}
+`;
+    output += `${import_chalk.default.cyan(userFrame.file)}:${import_chalk.default.yellow(userFrame.lineNumber)}:${import_chalk.default.yellow(userFrame.column)}   ${import_chalk.default.gray("\u2190 YOUR CODE")}
+
+`;
+  }
+  const suggestions = getSuggestions(error);
+  if (suggestions.length > 0) {
+    output += `${import_chalk.default.bold("\u{1F4A1} Suggestions:")}
+`;
+    for (const suggestion of suggestions) {
+      output += `\u2022 ${import_chalk.default.green(suggestion.message)}
+`;
+      if (suggestion.fix) {
+        output += `  ${import_chalk.default.dim("Fix: " + suggestion.fix)}
+`;
+      }
+    }
+    output += `
+`;
+  }
+  output += `${import_chalk.default.bold("\u{1F4E6} Stack:")}
+`;
+  let hiddenInternalsCount = 0;
+  let hiddenModulesCount = 0;
+  for (const frame of stackFrames) {
+    if (frame.isNodeInternal) {
+      hiddenInternalsCount++;
+      continue;
+    }
+    if (frame.isNodeModule) {
+      hiddenModulesCount++;
+      continue;
+    }
+    const fileStr = frame.file ? `${import_chalk.default.cyan(frame.file)}:${import_chalk.default.yellow(frame.lineNumber)}:${import_chalk.default.yellow(frame.column)}` : import_chalk.default.gray("<unknown>");
+    output += `\u2192 ${fileStr}
+`;
+  }
+  if (hiddenModulesCount > 0 || hiddenInternalsCount > 0) {
+    const hiddenMessages = [];
+    if (hiddenModulesCount > 0) hiddenMessages.push(`${hiddenModulesCount} node_modules`);
+    if (hiddenInternalsCount > 0) hiddenMessages.push(`${hiddenInternalsCount} node internals`);
+    output += import_chalk.default.dim(`(${hiddenMessages.join(" and ")} hidden)
+`);
+  }
+  return output;
+}
+
+// src/register.ts
+process.on("uncaughtException", (err) => {
+  console.error("\n \u{1F525} UNCAUGHT EXCEPTION DETECTED:");
+  console.error(formatError(err));
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  console.error("\n \u{1F525} UNHANDLED REJECTION DETECTED:");
+  console.error(formatError(reason instanceof Error ? reason : new Error(String(reason))));
+});
+console.log("\u2705 IntellError register loaded.");
+//# sourceMappingURL=register.cjs.map

package/dist/register.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formatter/index.ts","../src/parser/index.ts","../src/suggestions/rules.ts","../src/suggestions/index.ts","../src/register.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { parseStack } from '../parser/index.js';\nimport { getSuggestions } from '../suggestions/index.js';\n\nexport function formatError(error: Error | unknown): string {\n  if (!(error instanceof Error)) {\n    return String(error);\n  }\n\n  const stackFrames = parseStack(error);\n  \n  // Find first user frame that is not node internal or node_modules\n  const userFrame = stackFrames.find(frame => !frame.isNodeInternal && !frame.isNodeModule);\n\n  const errorType = error.constructor.name || 'Error';\n  const typeLabel = chalk.bgRed.white(` ${errorType} `);\n  let output = `\\n${typeLabel} ${chalk.red(error.message)}\\n\\n`;\n\n  if (userFrame && userFrame.file) {\n    output += `${chalk.bold('📍 Location:')}\\n`;\n    output += `${chalk.cyan(userFrame.file)}:${chalk.yellow(userFrame.lineNumber)}:${chalk.yellow(userFrame.column)}   ${chalk.gray('← YOUR CODE')}\\n\\n`;\n  }\n\n  const suggestions = getSuggestions(error);\n  if (suggestions.length > 0) {\n    output += `${chalk.bold('💡 Suggestions:')}\\n`;\n    for (const suggestion of suggestions) {\n      output += `• ${chalk.green(suggestion.message)}\\n`;\n      if (suggestion.fix) {\n          output += `  ${chalk.dim('Fix: ' + suggestion.fix)}\\n`;\n      }\n    }\n    output += `\\n`;\n  }\n\n  output += `${chalk.bold('📦 Stack:')}\\n`;\n  \n  let hiddenInternalsCount = 0;\n  let hiddenModulesCount = 0;\n\n  for (const frame of stackFrames) {\n    if (frame.isNodeInternal) {\n      hiddenInternalsCount++;\n      continue;\n    }\n    \n    if (frame.isNodeModule) {\n      hiddenModulesCount++;\n      continue; \n    }\n    \n    const fileStr = frame.file \n      ? `${chalk.cyan(frame.file)}:${chalk.yellow(frame.lineNumber)}:${chalk.yellow(frame.column)}` \n      : chalk.gray('<unknown>');\n      \n    output += `→ ${fileStr}\\n`;\n  }\n\n  if (hiddenModulesCount > 0 || hiddenInternalsCount > 0) {\n    const hiddenMessages = [];\n    if (hiddenModulesCount > 0) hiddenMessages.push(`${hiddenModulesCount} node_modules`);\n    if (hiddenInternalsCount > 0) hiddenMessages.push(`${hiddenInternalsCount} node internals`);\n    output += chalk.dim(`(${hiddenMessages.join(' and ')} hidden)\\n`);\n  }\n\n  return output;\n}\n","import * as stackTraceParser from 'stacktrace-parser';\n\nexport interface ParsedStackFrame {\n  file: string | null;\n  methodName: string;\n  lineNumber: number | null;\n  column: number | null;\n  isNodeInternal: boolean;\n  isNodeModule: boolean;\n}\n\nexport function parseStack(error: Error): ParsedStackFrame[] {\n  if (!error.stack) return [];\n  \n  const parsed = stackTraceParser.parse(error.stack);\n  \n  return parsed.map(frame => {\n    const file = frame.file || '';\n    \n    // Check if it's a built-in node module or internal\n    // e.g. node:internal/... or just internal/... or events.js\n    const isNodeInternal = \n      file.startsWith('node:') || \n      file.startsWith('internal/') ||\n      !file.includes('/') && !file.includes('\\\\'); // typically a core module if no path separators\n      \n    const isNodeModule = file.includes('node_modules');\n\n    return {\n      file: frame.file,\n      methodName: frame.methodName || '<unknown>',\n      lineNumber: frame.lineNumber,\n      column: frame.column,\n      isNodeInternal: Boolean(isNodeInternal),\n      isNodeModule: Boolean(isNodeModule)\n    };\n  });\n}\n","export interface SuggesionRule {\n  match: (error: Error) => boolean;\n  message: string;\n  fix?: string;\n  description?: string;\n}\n\nexport const rules: SuggesionRule[] = [\n  {\n    match: (err) => err.message.includes(\"Cannot read properties of undefined (reading '\") || err.message.includes(\"is not defined\"),\n    message: \"Accessing property on undefined/not defined object.\",\n    fix: \"User optional chaining like 'obj?.prop' or ensure the object is initialized.\",\n    description: \"You are trying to read a property from a variable that currently holds an undefined value.\"\n  },\n  {\n      match: (err) => err instanceof SyntaxError && err.message.includes(\"Unexpected token\"),\n      message: \"JSON Parsing or Code Syntax error.\",\n      fix: \"Check your JSON string for trailing commas, proper quotes, or syntax issues in your code.\",\n      description: \"The engine encountered something it didn't expect while parsing.\"\n  },\n  {\n      match: (err) => err.message.includes(\"is not a function\"),\n      message: \"Attempted to call a non-function value.\",\n      fix: \"Ensure that you're calling a property that is actually a function.\",\n      description: \"You probably tried to execute something that is a string, number, or object as if it were a function.\"\n  }\n];\n","import { rules, SuggesionRule } from './rules.js';\n\nexport function getSuggestions(error: Error): SuggesionRule[] {\n    return rules.filter(rule => rule.match(error));\n}\n","import { formatError } from './formatter/index.js';\n\n// Global hooks to catch all unhandled errors\nprocess.on('uncaughtException', (err) => {\n  console.error('\\n 🔥 UNCAUGHT EXCEPTION DETECTED:');\n  console.error(formatError(err));\n  process.exit(1);\n});\n\nprocess.on('unhandledRejection', (reason) => {\n  console.error('\\n 🔥 UNHANDLED REJECTION DETECTED:');\n  console.error(formatError(reason instanceof Error ? reason : new Error(String(reason))));\n});\n\nconsole.log('✅ IntellError register loaded.');\n"],"mappings":"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","names":["chalk"]}

package/dist/register.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/register.js

@@ -0,0 +1,124 @@
+// src/formatter/index.ts
+import chalk from "chalk";
+
+// src/parser/index.ts
+import * as stackTraceParser from "stacktrace-parser";
+function parseStack(error) {
+  if (!error.stack) return [];
+  const parsed = stackTraceParser.parse(error.stack);
+  return parsed.map((frame) => {
+    const file = frame.file || "";
+    const isNodeInternal = file.startsWith("node:") || file.startsWith("internal/") || !file.includes("/") && !file.includes("\\");
+    const isNodeModule = file.includes("node_modules");
+    return {
+      file: frame.file,
+      methodName: frame.methodName || "<unknown>",
+      lineNumber: frame.lineNumber,
+      column: frame.column,
+      isNodeInternal: Boolean(isNodeInternal),
+      isNodeModule: Boolean(isNodeModule)
+    };
+  });
+}
+
+// src/suggestions/rules.ts
+var rules = [
+  {
+    match: (err) => err.message.includes("Cannot read properties of undefined (reading '") || err.message.includes("is not defined"),
+    message: "Accessing property on undefined/not defined object.",
+    fix: "User optional chaining like 'obj?.prop' or ensure the object is initialized.",
+    description: "You are trying to read a property from a variable that currently holds an undefined value."
+  },
+  {
+    match: (err) => err instanceof SyntaxError && err.message.includes("Unexpected token"),
+    message: "JSON Parsing or Code Syntax error.",
+    fix: "Check your JSON string for trailing commas, proper quotes, or syntax issues in your code.",
+    description: "The engine encountered something it didn't expect while parsing."
+  },
+  {
+    match: (err) => err.message.includes("is not a function"),
+    message: "Attempted to call a non-function value.",
+    fix: "Ensure that you're calling a property that is actually a function.",
+    description: "You probably tried to execute something that is a string, number, or object as if it were a function."
+  }
+];
+
+// src/suggestions/index.ts
+function getSuggestions(error) {
+  return rules.filter((rule) => rule.match(error));
+}
+
+// src/formatter/index.ts
+function formatError(error) {
+  if (!(error instanceof Error)) {
+    return String(error);
+  }
+  const stackFrames = parseStack(error);
+  const userFrame = stackFrames.find((frame) => !frame.isNodeInternal && !frame.isNodeModule);
+  const errorType = error.constructor.name || "Error";
+  const typeLabel = chalk.bgRed.white(` ${errorType} `);
+  let output = `
+${typeLabel} ${chalk.red(error.message)}
+
+`;
+  if (userFrame && userFrame.file) {
+    output += `${chalk.bold("\u{1F4CD} Location:")}
+`;
+    output += `${chalk.cyan(userFrame.file)}:${chalk.yellow(userFrame.lineNumber)}:${chalk.yellow(userFrame.column)}   ${chalk.gray("\u2190 YOUR CODE")}
+
+`;
+  }
+  const suggestions = getSuggestions(error);
+  if (suggestions.length > 0) {
+    output += `${chalk.bold("\u{1F4A1} Suggestions:")}
+`;
+    for (const suggestion of suggestions) {
+      output += `\u2022 ${chalk.green(suggestion.message)}
+`;
+      if (suggestion.fix) {
+        output += `  ${chalk.dim("Fix: " + suggestion.fix)}
+`;
+      }
+    }
+    output += `
+`;
+  }
+  output += `${chalk.bold("\u{1F4E6} Stack:")}
+`;
+  let hiddenInternalsCount = 0;
+  let hiddenModulesCount = 0;
+  for (const frame of stackFrames) {
+    if (frame.isNodeInternal) {
+      hiddenInternalsCount++;
+      continue;
+    }
+    if (frame.isNodeModule) {
+      hiddenModulesCount++;
+      continue;
+    }
+    const fileStr = frame.file ? `${chalk.cyan(frame.file)}:${chalk.yellow(frame.lineNumber)}:${chalk.yellow(frame.column)}` : chalk.gray("<unknown>");
+    output += `\u2192 ${fileStr}
+`;
+  }
+  if (hiddenModulesCount > 0 || hiddenInternalsCount > 0) {
+    const hiddenMessages = [];
+    if (hiddenModulesCount > 0) hiddenMessages.push(`${hiddenModulesCount} node_modules`);
+    if (hiddenInternalsCount > 0) hiddenMessages.push(`${hiddenInternalsCount} node internals`);
+    output += chalk.dim(`(${hiddenMessages.join(" and ")} hidden)
+`);
+  }
+  return output;
+}
+
+// src/register.ts
+process.on("uncaughtException", (err) => {
+  console.error("\n \u{1F525} UNCAUGHT EXCEPTION DETECTED:");
+  console.error(formatError(err));
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  console.error("\n \u{1F525} UNHANDLED REJECTION DETECTED:");
+  console.error(formatError(reason instanceof Error ? reason : new Error(String(reason))));
+});
+console.log("\u2705 IntellError register loaded.");
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formatter/index.ts","../src/parser/index.ts","../src/suggestions/rules.ts","../src/suggestions/index.ts","../src/register.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { parseStack } from '../parser/index.js';\nimport { getSuggestions } from '../suggestions/index.js';\n\nexport function formatError(error: Error | unknown): string {\n  if (!(error instanceof Error)) {\n    return String(error);\n  }\n\n  const stackFrames = parseStack(error);\n  \n  // Find first user frame that is not node internal or node_modules\n  const userFrame = stackFrames.find(frame => !frame.isNodeInternal && !frame.isNodeModule);\n\n  const errorType = error.constructor.name || 'Error';\n  const typeLabel = chalk.bgRed.white(` ${errorType} `);\n  let output = `\\n${typeLabel} ${chalk.red(error.message)}\\n\\n`;\n\n  if (userFrame && userFrame.file) {\n    output += `${chalk.bold('📍 Location:')}\\n`;\n    output += `${chalk.cyan(userFrame.file)}:${chalk.yellow(userFrame.lineNumber)}:${chalk.yellow(userFrame.column)}   ${chalk.gray('← YOUR CODE')}\\n\\n`;\n  }\n\n  const suggestions = getSuggestions(error);\n  if (suggestions.length > 0) {\n    output += `${chalk.bold('💡 Suggestions:')}\\n`;\n    for (const suggestion of suggestions) {\n      output += `• ${chalk.green(suggestion.message)}\\n`;\n      if (suggestion.fix) {\n          output += `  ${chalk.dim('Fix: ' + suggestion.fix)}\\n`;\n      }\n    }\n    output += `\\n`;\n  }\n\n  output += `${chalk.bold('📦 Stack:')}\\n`;\n  \n  let hiddenInternalsCount = 0;\n  let hiddenModulesCount = 0;\n\n  for (const frame of stackFrames) {\n    if (frame.isNodeInternal) {\n      hiddenInternalsCount++;\n      continue;\n    }\n    \n    if (frame.isNodeModule) {\n      hiddenModulesCount++;\n      continue; \n    }\n    \n    const fileStr = frame.file \n      ? `${chalk.cyan(frame.file)}:${chalk.yellow(frame.lineNumber)}:${chalk.yellow(frame.column)}` \n      : chalk.gray('<unknown>');\n      \n    output += `→ ${fileStr}\\n`;\n  }\n\n  if (hiddenModulesCount > 0 || hiddenInternalsCount > 0) {\n    const hiddenMessages = [];\n    if (hiddenModulesCount > 0) hiddenMessages.push(`${hiddenModulesCount} node_modules`);\n    if (hiddenInternalsCount > 0) hiddenMessages.push(`${hiddenInternalsCount} node internals`);\n    output += chalk.dim(`(${hiddenMessages.join(' and ')} hidden)\\n`);\n  }\n\n  return output;\n}\n","import * as stackTraceParser from 'stacktrace-parser';\n\nexport interface ParsedStackFrame {\n  file: string | null;\n  methodName: string;\n  lineNumber: number | null;\n  column: number | null;\n  isNodeInternal: boolean;\n  isNodeModule: boolean;\n}\n\nexport function parseStack(error: Error): ParsedStackFrame[] {\n  if (!error.stack) return [];\n  \n  const parsed = stackTraceParser.parse(error.stack);\n  \n  return parsed.map(frame => {\n    const file = frame.file || '';\n    \n    // Check if it's a built-in node module or internal\n    // e.g. node:internal/... or just internal/... or events.js\n    const isNodeInternal = \n      file.startsWith('node:') || \n      file.startsWith('internal/') ||\n      !file.includes('/') && !file.includes('\\\\'); // typically a core module if no path separators\n      \n    const isNodeModule = file.includes('node_modules');\n\n    return {\n      file: frame.file,\n      methodName: frame.methodName || '<unknown>',\n      lineNumber: frame.lineNumber,\n      column: frame.column,\n      isNodeInternal: Boolean(isNodeInternal),\n      isNodeModule: Boolean(isNodeModule)\n    };\n  });\n}\n","export interface SuggesionRule {\n  match: (error: Error) => boolean;\n  message: string;\n  fix?: string;\n  description?: string;\n}\n\nexport const rules: SuggesionRule[] = [\n  {\n    match: (err) => err.message.includes(\"Cannot read properties of undefined (reading '\") || err.message.includes(\"is not defined\"),\n    message: \"Accessing property on undefined/not defined object.\",\n    fix: \"User optional chaining like 'obj?.prop' or ensure the object is initialized.\",\n    description: \"You are trying to read a property from a variable that currently holds an undefined value.\"\n  },\n  {\n      match: (err) => err instanceof SyntaxError && err.message.includes(\"Unexpected token\"),\n      message: \"JSON Parsing or Code Syntax error.\",\n      fix: \"Check your JSON string for trailing commas, proper quotes, or syntax issues in your code.\",\n      description: \"The engine encountered something it didn't expect while parsing.\"\n  },\n  {\n      match: (err) => err.message.includes(\"is not a function\"),\n      message: \"Attempted to call a non-function value.\",\n      fix: \"Ensure that you're calling a property that is actually a function.\",\n      description: \"You probably tried to execute something that is a string, number, or object as if it were a function.\"\n  }\n];\n","import { rules, SuggesionRule } from './rules.js';\n\nexport function getSuggestions(error: Error): SuggesionRule[] {\n    return rules.filter(rule => rule.match(error));\n}\n","import { formatError } from './formatter/index.js';\n\n// Global hooks to catch all unhandled errors\nprocess.on('uncaughtException', (err) => {\n  console.error('\\n 🔥 UNCAUGHT EXCEPTION DETECTED:');\n  console.error(formatError(err));\n  process.exit(1);\n});\n\nprocess.on('unhandledRejection', (reason) => {\n  console.error('\\n 🔥 UNHANDLED REJECTION DETECTED:');\n  console.error(formatError(reason instanceof Error ? reason : new Error(String(reason))));\n});\n\nconsole.log('✅ IntellError register loaded.');\n"],"mappings":"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","names":[]}

package/dist/suggestions/index.d.ts

@@ -0,0 +1,2 @@
+import { SuggesionRule } from './rules.js';
+export declare function getSuggestions(error: Error): SuggesionRule[];

package/dist/suggestions/rules.d.ts

@@ -0,0 +1,7 @@
+export interface SuggesionRule {
+    match: (error: Error) => boolean;
+    message: string;
+    fix?: string;
+    description?: string;
+}
+export declare const rules: SuggesionRule[];

package/examples/async-error.ts

@@ -0,0 +1,16 @@
+import { formatError } from '../src/index.js';
+
+async function fetchFromBackend() {
+  throw new Error("Failed to connect to the backend server.");
+}
+
+async function handleRequest() {
+  try {
+      await fetchFromBackend();
+  } catch (error) {
+      console.log('--- ASYNC ERROR EXAMPLE ---');
+      console.error(formatError(error));
+  }
+}
+
+handleRequest();

package/examples/basic-usage.ts

@@ -0,0 +1,18 @@
+import { formatError } from '../src/index.js';
+
+function triggerError() {
+  const obj: any = {};
+  // TypeError: Cannot read properties of undefined (reading 'first')
+  return obj.name.first; 
+}
+
+function processData() {
+  triggerError();
+}
+
+try {
+  processData();
+} catch (error) {
+  console.log('--- BASIC ERROR EXAMPLE ---');
+  console.log(formatError(error));
+}

package/examples/custom-error.ts

@@ -0,0 +1,21 @@
+import { formatError } from '../src/index.js';
+
+class ValidationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'ValidationError';
+  }
+}
+
+function validateInput(input: string) {
+  if (input.length < 5) {
+      throw new ValidationError("Input is too short! Must be at least 5 characters.");
+  }
+}
+
+try {
+  validateInput("abc");
+} catch (error) {
+  console.log('--- CUSTOM ERROR EXAMPLE ---');
+  console.log(formatError(error));
+}

package/examples/express-middleware.ts

@@ -0,0 +1,19 @@
+import express from 'express';
+import { errorFormatter } from '../src/index.js';
+
+const app = express();
+const port = 3000;
+
+app.get('/error', (_req, _res) => {
+  // Triggering a custom error
+  throw new Error("Simulated API Error in route handler");
+});
+
+// Use the IntellError middleware
+app.use(errorFormatter());
+
+console.log(`Server started at http://localhost:${port}`);
+console.log(`To see the formatted error, visit http://localhost:${port}/error`);
+
+// Don't listen to avoid hanging during build or automated test runs
+// app.listen(port);

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "intellerror",
+  "version": "1.0.0",
+  "description": "Intelligent error formatting for Node.js and Browser. Transforms ugly stack traces into clean, readable, and actionable output with smart code suggestions.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./register": {
+      "import": "./dist/register.js",
+      "require": "./dist/register.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "postbuild": "tsc --emitDeclarationOnly",
+    "dev": "tsup --watch",
+    "test": "tsx test.ts",
+    "test:unit": "vitest run",
+    "example:basic": "tsx examples/basic-usage.ts",
+    "example:async": "tsx examples/async-error.ts",
+    "example:custom": "tsx examples/custom-error.ts",
+    "examples:all": "npm run example:basic && npm run example:async && npm run example:custom"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/darshan1005/IntellError.git"
+  },
+  "keywords": [
+    "error",
+    "stack-trace",
+    "formatter",
+    "pretty-error",
+    "node",
+    "browser",
+    "react",
+    "vite",
+    "suggestions"
+  ],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/darshan1005/IntellError/issues"
+  },
+  "homepage": "https://github.com/darshan1005/IntellError#readme",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "diff": "^8.0.4",
+    "source-map-js": "^1.2.1",
+    "stacktrace-parser": "^0.1.11"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

package/src/config.ts

@@ -0,0 +1,31 @@
+export interface IntellErrorConfig {
+  showNodeModules: boolean;
+  showNodeInternals: boolean;
+  suggestionsEnabled: boolean;
+  interceptWarnings: boolean;
+  showSearchLinks: boolean;
+  webhookUrl?: string;
+}
+
+let config: IntellErrorConfig = {
+  showNodeModules: false,
+  showNodeInternals: false,
+  suggestionsEnabled: true,
+  interceptWarnings: false,
+  showSearchLinks: true,
+};
+
+/**
+ * Updates the global configuration for IntellError.
+ * @param newConfig Partial configuration object
+ */
+export function setupConfig(newConfig: Partial<IntellErrorConfig>) {
+  config = { ...config, ...newConfig };
+}
+
+/**
+ * Returns the current configuration.
+ */
+export function getConfig(): IntellErrorConfig {
+  return config;
+}

package/src/formatter/browser.ts

@@ -0,0 +1,166 @@
+import { parseStack } from '../parser/index.js';
+import { getSuggestions } from '../suggestions/index.js';
+import { getConfig } from '../config.js';
+import { getSearchLinks } from '../suggestions/links.js';
+
+/**
+ * Formats an error for the browser console using CSS styling (%c).
+ * Use it like: console.log(...formatErrorBrowser(err));
+ */
+export function formatErrorBrowser(error: Error | unknown): any[] {
+  if (!(error instanceof Error)) {
+    return [String(error)];
+  }
+
+  const config = getConfig();
+  const stackFrames = parseStack(error);
+  const userFrame = stackFrames.find(frame => !frame.isNodeInternal && !frame.isNodeModule);
+
+  const errorType = error.constructor.name || 'Error';
+
+  let text = `\n%c ${errorType} %c ${error.message}\n\n`;
+  const styles = [
+    'background: #ff4d4f; color: white; padding: 2px 4px; border-radius: 3px; font-weight: bold;',
+    'color: #ff4d4f; font-weight: bold;'
+  ];
+
+  if (userFrame && userFrame.file) {
+    text += `%c📍 Location:%c\n`;
+    styles.push('font-weight: bold;', '');
+    
+    text += `%c${userFrame.file}:${userFrame.lineNumber}:${userFrame.column}%c   (YOUR CODE)\n\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', 'color: grey; font-style: italic;');
+  }
+
+  const suggestions = config.suggestionsEnabled ? getSuggestions(error) : [];
+  if (suggestions.length > 0) {
+    text += `%c💡 Suggestions:%c\n`;
+    styles.push('font-weight: bold;', '');
+
+    for (const suggestion of suggestions) {
+      text += `%c• ${suggestion.message}%c\n`;
+      styles.push('color: #52c41a; font-weight: bold;', '');
+      
+      if (suggestion.description) {
+        text += `  %c${suggestion.description}%c\n`;
+        styles.push('color: grey;', '');
+      }
+      
+      if (suggestion.fix) {
+        text += `  %cFix: ${suggestion.fix}%c\n`;
+        styles.push('color: #1890ff;', '');
+      }
+    }
+    text += `\n`;
+  }
+
+  if (config.showSearchLinks) {
+    const searchLinks = getSearchLinks(error);
+    text += `%c🔍 Troubleshoot:%c\n`;
+    styles.push('font-weight: bold;', '');
+    
+    text += `Google: %c${searchLinks[0]}%c\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+    
+    text += `StackOverflow: %c${searchLinks[1]}%c\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+    
+    text += `GitHub: %c${searchLinks[2]}%c\n\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+  }
+
+  text += `%c📦 Stack:%c\n`;
+  styles.push('font-weight: bold;', '');
+
+  let hiddenInternalsCount = 0;
+  let hiddenModulesCount = 0;
+
+  for (const frame of stackFrames) {
+    if (frame.isNodeInternal && !config.showNodeInternals) {
+      hiddenInternalsCount++;
+      continue;
+    }
+    
+    if (frame.isNodeModule && !config.showNodeModules) {
+      hiddenModulesCount++;
+      continue; 
+    }
+    
+    const fileStr = frame.file 
+      ? `${frame.file}:${frame.lineNumber}:${frame.column}` 
+      : '<unknown>';
+      
+    text += `→ %c${fileStr}%c\n`;
+    styles.push('color: #1890ff;', '');
+  }
+
+  if (hiddenModulesCount > 0 || hiddenInternalsCount > 0) {
+    const messages = [];
+    if (hiddenModulesCount > 0) messages.push(`${hiddenModulesCount} node_modules`);
+    if (hiddenInternalsCount > 0) messages.push(`${hiddenInternalsCount} node internals`);
+    text += `%c(${messages.join(' and ')} hidden)%c\n`;
+    styles.push('color: grey; font-style: italic;', '');
+  }
+
+  return [text, ...styles];
+}
+
+export function formatWarningBrowser(message: string, error?: Error): any[] {
+  const config = getConfig();
+  const actualError = error || new Error(message);
+  const stackFrames = parseStack(actualError);
+  const userFrame = stackFrames.find(frame => !frame.isNodeInternal && !frame.isNodeModule);
+
+  let text = `\n%c WARNING %c ${message}\n\n`;
+  const styles = [
+    'background: #ffec3d; color: black; padding: 2px 4px; border-radius: 3px; font-weight: bold;',
+    'color: #d4b106; font-weight: bold;'
+  ];
+
+  if (userFrame && userFrame.file) {
+    text += `%c📍 Location:%c\n`;
+    styles.push('font-weight: bold;', '');
+    
+    text += `%c${userFrame.file}:${userFrame.lineNumber}:${userFrame.column}%c   (YOUR CODE)\n\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', 'color: grey; font-style: italic;');
+  }
+
+  const suggestions = config.suggestionsEnabled ? getSuggestions(actualError) : [];
+  if (suggestions.length > 0) {
+    text += `%c💡 Suggestions:%c\n`;
+    styles.push('font-weight: bold;', '');
+
+    for (const suggestion of suggestions) {
+      text += `%c• ${suggestion.message}%c\n`;
+      styles.push('color: #52c41a; font-weight: bold;', '');
+      
+      if (suggestion.description) {
+        text += `  %c${suggestion.description}%c\n`;
+        styles.push('color: grey;', '');
+      }
+      
+      if (suggestion.fix) {
+        text += `  %cFix: ${suggestion.fix}%c\n`;
+        styles.push('color: #1890ff;', '');
+      }
+    }
+    text += `\n`;
+  }
+
+  if (config.showSearchLinks) {
+    const searchLinks = getSearchLinks(actualError);
+    text += `%c🔍 Troubleshoot:%c\n`;
+    styles.push('font-weight: bold;', '');
+    
+    text += `Google: %c${searchLinks[0]}%c\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+    
+    text += `StackOverflow: %c${searchLinks[1]}%c\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+    
+    text += `GitHub: %c${searchLinks[2]}%c\n\n`;
+    styles.push('color: #1890ff; text-decoration: underline;', '');
+  }
+
+  return [text, ...styles];
+}