@visulima/error 4.4.17 → 4.5.0

package/dist/packem_shared/ruleBasedFinder-y_-5kbeT.cjs

@@ -0,0 +1,229 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const code = /* @__PURE__ */ __name((s) => `\`\`\`
+${s.trim()}
+\`\`\``, "code");
+const bash = /* @__PURE__ */ __name((s) => `\`\`\`bash
+${s.trim()}
+\`\`\``, "bash");
+const ts = /* @__PURE__ */ __name((s) => `\`\`\`ts
+${s.trim()}
+\`\`\``, "ts");
+const js = /* @__PURE__ */ __name((s) => `\`\`\`js
+${s.trim()}
+\`\`\``, "js");
+const has = /* @__PURE__ */ __name((message, ...needles) => {
+  const lower = message.toLowerCase();
+  return needles.some((n) => lower.includes(n.toLowerCase()));
+}, "has");
+const rules = [
+  {
+    name: "esm-cjs-interop",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(
+        message,
+        "err_require_esm",
+        "cannot use import statement outside a module",
+        "must use import to load es module",
+        "require() of es module",
+        "does not provide an export named"
+      )) {
+        return {
+          md: [
+            "Your project or a dependency may be mixing CommonJS and ES Modules.",
+            "",
+            "Try:",
+            "- Ensure package.json has the correct `type` (either `module` or `commonjs`).",
+            "- Use dynamic `import()` when requiring ESM from CJS.",
+            "- Prefer ESM-compatible entrypoints from dependencies.",
+            "- In Node, align `module` resolution with your bundler config.",
+            "",
+            "Check Node resolution:",
+            bash("node -v\ncat package.json | jq .type"),
+            "",
+            "Example dynamic import in CJS:",
+            js("(async () => { const mod = await import('some-esm'); mod.default(); })();")
+          ].join("\n"),
+          title: "ESM/CJS interop"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "missing-default-export",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "default export not found", "has no default export", "does not provide an export named 'default'", "is not exported from")) {
+        return {
+          md: [
+            "Verify your import/export shapes.",
+            "",
+            "Default export example:",
+            ts("export default function Component() {}\n// import Component from './file'"),
+            "",
+            "Named export example:",
+            ts("export function Component() {}\n// import { Component } from './file'")
+          ].join("\n"),
+          title: "Export mismatch (default vs named)"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "port-in-use",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "eaddrinuse", "address already in use", "listen eaddrinuse")) {
+        return {
+          md: [
+            "Another process is using the port.",
+            "",
+            "Change the port or stop the other process.",
+            "",
+            "On macOS/Linux:",
+            bash("lsof -i :3000\nkill -9 <PID>"),
+            "",
+            "On Windows (PowerShell):",
+            bash("netstat -ano | findstr :3000\ntaskkill /PID <PID> /F")
+          ].join("\n"),
+          title: "Port already in use"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "file-not-found-or-case",
+    test: /* @__PURE__ */ __name((error, file) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "enoent", "module not found", "cannot find module")) {
+        return {
+          md: [
+            "Check the import path and filename case (Linux/macOS are case-sensitive).",
+            "If using TS path aliases, verify `tsconfig.paths` and bundler aliases.",
+            "",
+            "Current file:",
+            code(`${file.file}:${file.line}`)
+          ].join("\n"),
+          title: "Missing file or path case mismatch"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "ts-path-mapping",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "ts2307", "cannot find module") || message.includes("TS2307")) {
+        return {
+          md: [
+            "If you use path aliases, align TS `paths` with Vite/Webpack resolve aliases.",
+            "Ensure file extensions are correct and included in resolver.",
+            "",
+            "tsconfig.json excerpt:",
+            ts(`{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": { "@/*": ["src/*"] }
+  }
+}`)
+          ].join("\n"),
+          title: "TypeScript path mapping / resolution"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "network-dns-enotfound",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "enotfound", "getaddrinfo enotfound", "dns", "fetch failed", "ecconnrefused", "econnrefused")) {
+        return {
+          md: [
+            "The host may be unreachable or misconfigured.",
+            "",
+            "Try:",
+            "- Verify the hostname and protocol (http/https).",
+            "- Check VPN/proxy and firewall.",
+            "- Confirm the service is running and listening on the expected port.",
+            "",
+            bash("ping <host>\nnslookup <host>\ncurl -v http://<host>:<port>")
+          ].join("\n"),
+          title: "Network/DNS connection issue"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "react-hydration-mismatch",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "hydration failed", "did not match", "expected server html", "text content does not match")) {
+        return {
+          md: [
+            "Client and server rendered markup differ.",
+            "",
+            "Checklist:",
+            "- Avoid non-deterministic rendering during SSR (dates, random, locale).",
+            "- Ensure feature flags / env checks are consistent between server and client.",
+            "- Wrap browser-only code with guards (e.g., check `typeof window !== 'undefined'`).",
+            "- Ensure data used on server matches client rehydration data."
+          ].join("\n"),
+          title: "React hydration mismatch"
+        };
+      }
+      return void 0;
+    }, "test")
+  },
+  {
+    name: "undefined-property",
+    test: /* @__PURE__ */ __name((error) => {
+      const message = (error?.message || String(error || "")).toString();
+      if (has(message, "cannot read properties of undefined", "reading '")) {
+        return {
+          md: [
+            "A variable or function returned `undefined`.",
+            "",
+            "Mitigations:",
+            "- Add nullish checks before property access.",
+            "- Validate function return values and input props/state.",
+            "",
+            ts("const value = maybe?.prop; // or: if (maybe) { use(maybe.prop) }")
+          ].join("\n"),
+          title: "Accessing property of undefined"
+        };
+      }
+      return void 0;
+    }, "test")
+  }
+];
+const ruleBasedFinder = {
+  handle: /* @__PURE__ */ __name(async (error, file) => {
+    try {
+      const matches = rules.map((r) => {
+        return { match: r.test(error, file), rule: r };
+      }).filter((x) => Boolean(x.match));
+      if (matches.length === 0) {
+        return void 0;
+      }
+      const sections = matches.sort((a, b) => (a.match.priority || 0) - (b.match.priority || 0)).map((m) => `#### ${m.match.title}
+
+${m.match.md}`).join("\n\n---\n\n");
+      return { body: sections, header: "### Potential fixes detected" };
+    } catch {
+      return void 0;
+    }
+  }, "handle"),
+  name: "ruleBasedHints",
+  priority: 0
+};
+
+module.exports = ruleBasedFinder;

package/dist/packem_shared/types-BtQS7FHG.d.cts

@@ -0,0 +1,20 @@
+type Solution = {
+    body: string;
+    header?: string;
+};
+type SolutionFinderFile = {
+    file: string;
+    language?: string;
+    line: number;
+    snippet?: string | undefined;
+};
+type SolutionFinder = {
+    handle: (error: any, file: SolutionFinderFile) => Promise<Solution | undefined>;
+    name: string;
+    priority: number;
+};
+type SolutionError = Error & {
+    hint?: Solution;
+};
+
+export type { Solution as S, SolutionError as a, SolutionFinder as b, SolutionFinderFile as c };

package/dist/packem_shared/types-BtQS7FHG.d.mts

@@ -0,0 +1,20 @@
+type Solution = {
+    body: string;
+    header?: string;
+};
+type SolutionFinderFile = {
+    file: string;
+    language?: string;
+    line: number;
+    snippet?: string | undefined;
+};
+type SolutionFinder = {
+    handle: (error: any, file: SolutionFinderFile) => Promise<Solution | undefined>;
+    name: string;
+    priority: number;
+};
+type SolutionError = Error & {
+    hint?: Solution;
+};
+
+export type { Solution as S, SolutionError as a, SolutionFinder as b, SolutionFinderFile as c };

package/dist/packem_shared/types-BtQS7FHG.d.ts

@@ -0,0 +1,20 @@
+type Solution = {
+    body: string;
+    header?: string;
+};
+type SolutionFinderFile = {
+    file: string;
+    language?: string;
+    line: number;
+    snippet?: string | undefined;
+};
+type SolutionFinder = {
+    handle: (error: any, file: SolutionFinderFile) => Promise<Solution | undefined>;
+    name: string;
+    priority: number;
+};
+type SolutionError = Error & {
+    hint?: Solution;
+};
+
+export type { Solution as S, SolutionError as a, SolutionFinder as b, SolutionFinderFile as c };

package/dist/solution/ai/ai-prompt.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const aiPrompt = /* @__PURE__ */ __name(({
+  applicationType,
+  error,
+  file
+}) => `You are a very skilled ${file.language} programmer.
+
+${applicationType ? `You are working on a ${applicationType} application.` : ""}
+
+Use the following context to find a possible fix for the exception message at the end. Limit your answer to 4 or 5 sentences. Also include a few links to documentation that might help.
+
+Use this format in your answer, make sure links are json:
+
+FIX
+insert the possible fix here
+ENDFIX
+LINKS
+{"title": "Title link 1", "url": "URL link 1"}
+{"title": "Title link 2", "url": "URL link 2"}
+ENDLINKS
+---
+
+Here comes the context and the exception message:
+
+Line: ${file.line}
+
+File:
+${file.file}
+
+Snippet including line numbers:
+${file.snippet}
+
+Exception class:
+${error.name}
+
+Exception message:
+${error.message}`, "aiPrompt");
+
+module.exports = aiPrompt;

package/dist/solution/ai/ai-prompt.d.cts

@@ -0,0 +1,9 @@
+import { c as SolutionFinderFile } from '../../packem_shared/types-BtQS7FHG.cjs';
+
+declare const aiPrompt: ({ applicationType, error, file, }: {
+    applicationType: string | undefined;
+    error: Error;
+    file: SolutionFinderFile;
+}) => string;
+
+export = aiPrompt;

package/dist/solution/ai/ai-prompt.d.mts

@@ -0,0 +1,9 @@
+import { c as SolutionFinderFile } from '../../packem_shared/types-BtQS7FHG.mjs';
+
+declare const aiPrompt: ({ applicationType, error, file, }: {
+    applicationType: string | undefined;
+    error: Error;
+    file: SolutionFinderFile;
+}) => string;
+
+export { aiPrompt as default };

package/dist/solution/ai/ai-prompt.d.ts

@@ -0,0 +1,9 @@
+import { c as SolutionFinderFile } from '../../packem_shared/types-BtQS7FHG.js';
+
+declare const aiPrompt: ({ applicationType, error, file, }: {
+    applicationType: string | undefined;
+    error: Error;
+    file: SolutionFinderFile;
+}) => string;
+
+export = aiPrompt;

package/dist/solution/ai/ai-prompt.mjs

@@ -0,0 +1,40 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const aiPrompt = /* @__PURE__ */ __name(({
+  applicationType,
+  error,
+  file
+}) => `You are a very skilled ${file.language} programmer.
+
+${applicationType ? `You are working on a ${applicationType} application.` : ""}
+
+Use the following context to find a possible fix for the exception message at the end. Limit your answer to 4 or 5 sentences. Also include a few links to documentation that might help.
+
+Use this format in your answer, make sure links are json:
+
+FIX
+insert the possible fix here
+ENDFIX
+LINKS
+{"title": "Title link 1", "url": "URL link 1"}
+{"title": "Title link 2", "url": "URL link 2"}
+ENDLINKS
+---
+
+Here comes the context and the exception message:
+
+Line: ${file.line}
+
+File:
+${file.file}
+
+Snippet including line numbers:
+${file.snippet}
+
+Exception class:
+${error.name}
+
+Exception message:
+${error.message}`, "aiPrompt");
+
+export { aiPrompt as default };

package/dist/solution/ai/index.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const aiFinder = require('../../packem_shared/aiFinder-BGfwKKxE.cjs');
+const solution_ai_aiPrompt = require('./ai-prompt.cjs');
+const aiSolutionResponse = require('../../packem_shared/aiSolutionResponse-BPckbL56.cjs');
+
+
+
+exports.aiFinder = aiFinder;
+exports.aiPrompt = solution_ai_aiPrompt;
+exports.aiSolutionResponse = aiSolutionResponse;

package/dist/solution/ai/index.d.cts

@@ -0,0 +1,16 @@
+import { LanguageModel } from 'ai';
+import { b as SolutionFinder } from '../../packem_shared/types-BtQS7FHG.cjs';
+export { default as aiPrompt } from './ai-prompt.cjs';
+export { a as aiSolutionResponse } from '../../packem_shared/ai-solution-response-BuaDQAEU.cjs';
+
+interface CacheOptions {
+    enabled?: boolean;
+    directory?: string;
+    ttl?: number;
+}
+declare const aiFinder: (model: LanguageModel, options?: {
+    temperature?: number;
+    cache?: CacheOptions;
+}) => SolutionFinder;
+
+export { aiFinder };

package/dist/solution/ai/index.d.mts

@@ -0,0 +1,16 @@
+import { LanguageModel } from 'ai';
+import { b as SolutionFinder } from '../../packem_shared/types-BtQS7FHG.mjs';
+export { default as aiPrompt } from './ai-prompt.mjs';
+export { a as aiSolutionResponse } from '../../packem_shared/ai-solution-response-BuaDQAEU.mjs';
+
+interface CacheOptions {
+    enabled?: boolean;
+    directory?: string;
+    ttl?: number;
+}
+declare const aiFinder: (model: LanguageModel, options?: {
+    temperature?: number;
+    cache?: CacheOptions;
+}) => SolutionFinder;
+
+export { aiFinder };

package/dist/solution/ai/index.d.ts

@@ -0,0 +1,16 @@
+import { LanguageModel } from 'ai';
+import { b as SolutionFinder } from '../../packem_shared/types-BtQS7FHG.js';
+export { default as aiPrompt } from './ai-prompt.js';
+export { a as aiSolutionResponse } from '../../packem_shared/ai-solution-response-BuaDQAEU.js';
+
+interface CacheOptions {
+    enabled?: boolean;
+    directory?: string;
+    ttl?: number;
+}
+declare const aiFinder: (model: LanguageModel, options?: {
+    temperature?: number;
+    cache?: CacheOptions;
+}) => SolutionFinder;
+
+export { aiFinder };

package/dist/solution/ai/index.mjs

@@ -0,0 +1,3 @@
+export { default as aiFinder } from '../../packem_shared/aiFinder-Bk1vt0_x.mjs';
+export { default as aiPrompt } from './ai-prompt.mjs';
+export { default as aiSolutionResponse } from '../../packem_shared/aiSolutionResponse-bDi4ad8f.mjs';

package/dist/solution/index.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const errorHintFinder = require('../packem_shared/errorHintFinder-DZugFHq0.cjs');
+const ruleBasedFinder = require('../packem_shared/ruleBasedFinder-y_-5kbeT.cjs');
+
+
+
+exports.errorHintFinder = errorHintFinder;
+exports.ruleBasedFinder = ruleBasedFinder;

package/dist/solution/index.d.cts

@@ -0,0 +1,8 @@
+import { b as SolutionFinder } from '../packem_shared/types-BtQS7FHG.cjs';
+export { S as Solution, a as SolutionError, c as SolutionFinderFile } from '../packem_shared/types-BtQS7FHG.cjs';
+
+declare const errorHintFinder: SolutionFinder;
+
+declare const ruleBasedFinder: SolutionFinder;
+
+export { SolutionFinder, errorHintFinder, ruleBasedFinder };

package/dist/solution/index.d.mts

@@ -0,0 +1,8 @@
+import { b as SolutionFinder } from '../packem_shared/types-BtQS7FHG.mjs';
+export { S as Solution, a as SolutionError, c as SolutionFinderFile } from '../packem_shared/types-BtQS7FHG.mjs';
+
+declare const errorHintFinder: SolutionFinder;
+
+declare const ruleBasedFinder: SolutionFinder;
+
+export { SolutionFinder, errorHintFinder, ruleBasedFinder };

package/dist/solution/index.d.ts

@@ -0,0 +1,8 @@
+import { b as SolutionFinder } from '../packem_shared/types-BtQS7FHG.js';
+export { S as Solution, a as SolutionError, c as SolutionFinderFile } from '../packem_shared/types-BtQS7FHG.js';
+
+declare const errorHintFinder: SolutionFinder;
+
+declare const ruleBasedFinder: SolutionFinder;
+
+export { SolutionFinder, errorHintFinder, ruleBasedFinder };

package/dist/solution/index.mjs

@@ -0,0 +1,2 @@
+export { default as errorHintFinder } from '../packem_shared/errorHintFinder-CQy_qIK3.mjs';
+export { default as ruleBasedFinder } from '../packem_shared/ruleBasedFinder-BYrndubA.mjs';

package/dist/stacktrace/index.cjs

@@ -3,7 +3,10 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 const parseStacktrace = require('../packem_shared/parseStacktrace-6pFoXW43.cjs');
+const formatStackFrameLine = require('../packem_shared/formatStackFrameLine-DcXSX--m.cjs');
 
 
 
 exports.parseStacktrace = parseStacktrace;
+exports.formatStackFrameLine = formatStackFrameLine.formatStackFrameLine;
+exports.formatStacktrace = formatStackFrameLine.formatStacktrace;

package/dist/stacktrace/index.d.cts

@@ -14,4 +14,12 @@ declare const parse: (error: Error, { filter, frameLimit }?: Partial<{
     frameLimit: number;
 }>) => Trace[];
 
-export { type Trace, type TraceType, parse as parseStacktrace };
+declare const formatStackFrameLine: (frame: Trace) => string;
+declare const formatStacktrace: (frames: Trace[], options?: {
+    header?: {
+        message?: string;
+        name?: string;
+    };
+}) => string;
+
+export { type Trace, type TraceType, formatStackFrameLine, formatStacktrace, parse as parseStacktrace };

package/dist/stacktrace/index.d.mts

@@ -14,4 +14,12 @@ declare const parse: (error: Error, { filter, frameLimit }?: Partial<{
     frameLimit: number;
 }>) => Trace[];
 
-export { type Trace, type TraceType, parse as parseStacktrace };
+declare const formatStackFrameLine: (frame: Trace) => string;
+declare const formatStacktrace: (frames: Trace[], options?: {
+    header?: {
+        message?: string;
+        name?: string;
+    };
+}) => string;
+
+export { type Trace, type TraceType, formatStackFrameLine, formatStacktrace, parse as parseStacktrace };

package/dist/stacktrace/index.d.ts

@@ -14,4 +14,12 @@ declare const parse: (error: Error, { filter, frameLimit }?: Partial<{
     frameLimit: number;
 }>) => Trace[];
 
-export { type Trace, type TraceType, parse as parseStacktrace };
+declare const formatStackFrameLine: (frame: Trace) => string;
+declare const formatStacktrace: (frames: Trace[], options?: {
+    header?: {
+        message?: string;
+        name?: string;
+    };
+}) => string;
+
+export { type Trace, type TraceType, formatStackFrameLine, formatStacktrace, parse as parseStacktrace };

package/dist/stacktrace/index.mjs

@@ -1 +1,2 @@
 export { default as parseStacktrace } from '../packem_shared/parseStacktrace-BKGoWCwC.mjs';
+export { formatStackFrameLine, formatStacktrace } from '../packem_shared/formatStackFrameLine-DqkmKWH3.mjs';