@visulima/error-handler 2.0.0-alpha.8 → 2.0.0

package/README.md

@@ -61,6 +61,9 @@ pnpm add @visulima/error-handler
 
 ### Node.js HTTP Server
 
+`httpHandler(error, options?)` is synchronous and returns the `(req, res)`
+request handler — there is no need to `await` it.
+
 ```ts
 import { createServer } from "node:http";
 import httpHandler from "@visulima/error-handler/handler/http/node";
@@ -70,10 +73,10 @@ const server = createServer(async (req, res) => {
         // your app logic...
         throw new Error("Boom!");
     } catch (error) {
-        const handler = await httpHandler(error as Error, {
+        const handler = httpHandler(error as Error, {
             showTrace: process.env.NODE_ENV !== "production",
         });
-        return handler(req, res);
+        await handler(req, res);
     }
 });
 
@@ -82,27 +85,36 @@ server.listen(3000);
 
 ### Express Setup
 
+Prefer the one-line error middleware instead of wrapping every route in
+`try/catch`. Register `createErrorMiddleware` once and Express will route any
+error (thrown synchronously or passed to `next(error)`) through it:
+
 ```ts
 import express from "express";
-import httpHandler from "@visulima/error-handler/handler/http/node";
+import { createErrorMiddleware } from "@visulima/error-handler";
 
 const app = express();
 app.use(express.json());
 
-app.get("/", async (req, res) => {
-    try {
-        throw new Error("Example error");
-    } catch (error) {
-        const handler = await httpHandler(error as Error, {
-            showTrace: process.env.NODE_ENV !== "production",
-        });
-        return handler(req, res);
-    }
+app.get("/", () => {
+    throw new Error("Example error");
 });
 
+// Must be registered last, after your routes.
+app.use(
+    createErrorMiddleware({
+        showTrace: process.env.NODE_ENV !== "production",
+    }),
+);
+
 app.listen(3000);
 ```
 
+> `createErrorMiddleware` is also available as a subpath import:
+> `import createErrorMiddleware from "@visulima/error-handler/handler/middleware";`.
+> If the response has already started streaming (`res.headersSent`) it delegates
+> to `next(error)` so it never double-writes.
+
 ### Hono (Fetch Runtime)
 
 ```ts
@@ -118,7 +130,7 @@ app.get("/error", () => {
 });
 
 app.onError(async (error, c) => {
-    const handler = await fetchHandler(error as Error, {
+    const handler = fetchHandler(error as Error, {
         showTrace: process.env.NODE_ENV !== "production",
     });
     return handler(c.req.raw);
@@ -138,7 +150,7 @@ export default {
         try {
             throw new Error("Boom");
         } catch (error) {
-            const handler = await fetchHandler(error as Error, {
+            const handler = fetchHandler(error as Error, {
                 showTrace: process.env.NODE_ENV !== "production",
             });
             return handler(request);
@@ -155,7 +167,7 @@ Deno.serve(async (request: Request) => {
     try {
         throw new Error("Boom");
     } catch (error) {
-        const handler = await fetchHandler(error as Error, {
+        const handler = fetchHandler(error as Error, {
             showTrace: process.env.NODE_ENV !== "production",
         });
         return handler(request);
@@ -181,7 +193,7 @@ Add custom handlers for specific content types:
 ```ts
 import httpHandler from "@visulima/error-handler/handler/http/node";
 
-const handler = await httpHandler(error, {
+const handler = httpHandler(error, {
     extraHandlers: [
         {
             regex: /application\/yaml/u,
@@ -196,9 +208,11 @@ const handler = await httpHandler(error, {
 
 ## API
 
-### httpHandler(error, options?) => Promise<(req, res) => Promise<void>>
+### httpHandler(error, options?) => (req, res) => Promise<void>
 
 Node.js HTTP handler for Express, Connect, Fastify, Koa, and similar frameworks.
+The factory is synchronous and returns the `(req, res)` request handler — do not
+`await` it.
 
 **Parameters:**
 
@@ -207,15 +221,16 @@ Node.js HTTP handler for Express, Connect, Fastify, Koa, and similar frameworks.
 
 **Options:**
 
-- `showTrace?: boolean` - Include stack trace in responses (default: `true`)
+- `showTrace?: boolean` - Include stack trace in responses (default: `process.env.NODE_ENV !== "production"`)
 - `extraHandlers?: ErrorHandlers` - Custom handlers for specific Accept headers
 - `errorPage?: string | ((params) => string | Promise<string>)` - Custom HTML error page
 - `cspNonce?: string` - Content Security Policy nonce for inline styles
 - `onError?: (error, request, response) => void | Promise<void>` - Callback for custom error logging
 
-### fetchHandler(error, options?) => Promise<(request) => Promise<Response>>
+### fetchHandler(error, options?) => (request) => Promise<Response>
 
 Fetch API handler for Cloudflare Workers, Deno, Bun, and other Fetch-based runtimes.
+Like `httpHandler`, the factory is synchronous — do not `await` it.
 
 **Parameters:**
 
@@ -267,7 +282,7 @@ const server = createServer(async (req, res) => {
     try {
         throw new Error("Test error");
     } catch (error) {
-        const handler = await httpHandler(error as Error, {
+        const handler = httpHandler(error as Error, {
             showTrace: process.env.NODE_ENV !== "production",
         });
         return handler(req, res);
@@ -280,7 +295,7 @@ const server = createServer(async (req, res) => {
 ```ts
 import httpHandler from "@visulima/error-handler/handler/http/node";
 
-const handler = await httpHandler(error, {
+const handler = httpHandler(error, {
     errorPage: ({ error, statusCode }) =>
         `<!DOCTYPE html>
         <html>
@@ -299,7 +314,7 @@ const handler = await httpHandler(error, {
 ```ts
 import httpHandler from "@visulima/error-handler/handler/http/node";
 
-const handler = await httpHandler(error, {
+const handler = httpHandler(error, {
     cspNonce: "nonce-abc123", // Will be added to <style> tags
     showTrace: process.env.NODE_ENV !== "production",
 });
@@ -310,7 +325,7 @@ const handler = await httpHandler(error, {
 ```ts
 import httpHandler from "@visulima/error-handler/handler/http/node";
 
-const handler = await httpHandler(error, {
+const handler = httpHandler(error, {
     onError: (error, request, response) => {
         // Log to your preferred logging service
         console.error(`[${new Date().toISOString()}] ${request.method} ${request.url} - ${error.message}`);

package/dist/error-handler/fetch-utils.d.ts

@@ -0,0 +1,3 @@
+declare const extractStatusCode: (error: unknown, fallback?: number) => number;
+declare const sendFetchJson: (jsonBody: unknown, status: number, contentType?: string) => Response;
+export { extractStatusCode, sendFetchJson };

package/dist/error-handler/fetch-utils.js

@@ -0,0 +1 @@
+import{default as a}from"../packem_shared/extractStatusCode-D0UOgNnr.js";import{default as r}from"../packem_shared/sendFetchJson-BNmfrMYp.js";export{a as extractStatusCode,r as sendFetchJson};

package/dist/error-handler/html-error-handler.d.ts

@@ -1,13 +1,55 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ErrorHandler } from "./types.d.d.ts";
-export type HtmlErrorHandlerOptions = {
-    cspNonce?: string;
-    errorPage?: string | ((parameters: {
-        error: Error;
-        reasonPhrase: string;
-        request: IncomingMessage;
-        response: ServerResponse;
-        statusCode: number;
-    }) => string | Promise<string>);
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+import { SolutionFinder } from '@visulima/error/solution';
+/**
+* Options that influence how the development HTML error inspector is rendered.
+*/
+type HtmlErrorInspectorOptions = {
+  /**
+  * Permit the underlying code-frame reader to fetch `http(s):`/`data:`
+  * stack-frame URLs over the network. Off by default to avoid an SSRF
+  * surface; only enable when frame URLs are known to be trusted.
+  * @default false
+  */
+  allowRemoteSources?: boolean;
+  /**
+  * Number of source lines rendered above the offending line in the code frame.
+  * @default 4
+  */
+  linesAbove?: number;
+  /**
+  * Number of source lines rendered below the offending line in the code frame.
+  * @default 4
+  */
+  linesBelow?: number;
+  /**
+  * Extra solution finders to run before the built-in rule-based and
+  * error-hint finders. The first finder (sorted by descending priority)
+  * that returns a hint wins. Matches the CLI handler's behaviour.
+  */
+  solutionFinders?: SolutionFinder[];
 };
-export declare const htmlErrorHandler: (options?: HtmlErrorHandlerOptions) => ErrorHandler;
+/**
+* Builds the inner HTML for the development error inspector: error name +
+* message, a syntax-free code frame for the offending source line, the parsed
+* stack trace (one entry per cause), and a possible-solution hint.
+*
+* All dynamic content is HTML-escaped. This is intended for development output
+* only — callers must keep it off the production path so stack/source are not
+* leaked.
+* @param error The error to render.
+* @param options Inspector rendering options.
+* @returns The escaped inner HTML for the inspector.
+*/
+declare const htmlErrorHandler: (options?: HtmlErrorHandlerOptions) => ErrorHandler;
+type HtmlErrorHandlerOptions = HtmlErrorInspectorOptions & {
+  cspNonce?: string;
+  errorPage?: string | ((parameters: {
+    error: Error;
+    reasonPhrase: string;
+    request: IncomingMessage;
+    response: ServerResponse;
+    statusCode: number;
+  }) => string | Promise<string>);
+};
+export { HtmlErrorHandlerOptions, htmlErrorHandler };

package/dist/error-handler/html-error-handler.js

@@ -1,35 +1,75 @@
-var l=Object.defineProperty;var n=(e,r)=>l(e,"name",{value:r,configurable:!0});import{getReasonPhrase as c}from"http-status-codes";import{a as m}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";var g=Object.defineProperty,s=n((e,r)=>g(e,"name",{value:r,configurable:!0}),"n");const x=s((e={})=>async(r,d,t)=>{m(t,r),t.setHeader("content-type","text/html; charset=utf-8");const o=c(t.statusCode)||"Error",a=e.cspNonce?` nonce="${e.cspNonce}"`:"";if(e.errorPage){const i=typeof e.errorPage=="function"?await e.errorPage({error:r,reasonPhrase:o,request:d,response:t,statusCode:t.statusCode}):e.errorPage;if(i){t.end(i);return}}t.end(String.raw`<!DOCTYPE html>
+import{getReasonPhrase as x}from"http-status-codes";import{a as u}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{codeFrame as v}from"@visulima/error/code-frame";import{getErrorCauses as w}from"@visulima/error/error";import{ruleBasedFinder as k,errorHintFinder as S}from"@visulima/error/solution";import{parseStacktrace as $}from"@visulima/error/stacktrace";import{h as j,a as C}from"../packem_shared/get-file-source-By3_8e1o.js";const A=/^\s*#+\s*/,l=e=>e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&#39;"),z=e=>e.replace(A,"").trim(),M=async(e,r,t,o)=>{const n=[...r,k,S].toSorted((i,s)=>i.priority-s.priority);for(const i of n){if(typeof i.handle!="function")continue;const s=await i.handle(e,{file:t.file??"",language:C(t.file??""),line:t.line??0,snippet:o});if(s)return s}},N=e=>{if(!e.file)return l(e.raw);let r=l(e.file);return e.line!==void 0&&(r+=`:${String(e.line)}`,e.column!==void 0&&(r+=`:${String(e.column)}`)),r},E=e=>{if(e.length===0)return"";const r=e.map(t=>{const o=l(t.methodName??"<anonymous>"),n=N(t);return String.raw`<li class="vis-frame"><span class="vis-frame-method">${o}</span><span class="vis-frame-loc">${n}</span></li>`}).join("");return String.raw`<ol class="vis-frames">${r}</ol>`},B=e=>{if(!e)return"";const r=l(z(e.header??"A possible solution to this error")),t=l(e.body);return String.raw`
+                <section class="vis-card vis-solution">
+                    <h2 class="vis-card-title">💡 ${r}</h2>
+                    <pre class="vis-solution-body">${t}</pre>
+                </section>`},F=async(e,r={})=>{const{allowRemoteSources:t=!1,linesAbove:o=4,linesBelow:n=4,solutionFinders:i=[]}=r,s=w(e)[0]??e,c=$(s),a=c.find(d=>!!d.file)??c[0]??{};let m="",g="";if(a.file&&a.line!==void 0){const d=await j(a.file,{allowRemote:t});if(d){g=d;const h=v(d,{start:{column:a.column,line:a.line}},{linesAbove:o,linesBelow:n});m=String.raw`
+                <section class="vis-card">
+                    <h2 class="vis-card-title">${l(`${a.file}:${String(a.line)}`)}</h2>
+                    <pre class="vis-codeframe"><code>${l(h)}</code></pre>
+                </section>`}}const p=await M(e,i,a,g),f=l(e.name||"Error"),b=l(e.message||""),y=c.length>0?String.raw`
+                <section class="vis-card">
+                    <h2 class="vis-card-title">Stack trace</h2>
+                    ${E(c)}
+                </section>`:"";return String.raw`
+            <div class="vis-inspector max-w-6xl mx-auto px-6 mt-8">
+                <section class="vis-card vis-headline">
+                    <span class="vis-error-name">${f}</span>
+                    <p class="vis-error-message">${b}</p>
+                </section>${m}${B(p)}${y}
+            </div>`},I=String.raw`
+            .vis-inspector { display: flex; flex-direction: column; gap: 1rem; }
+            .vis-card { background: #fff; border-radius: .5rem; box-shadow: 0 1px 3px 0 rgba(0,0,0,.1),0 1px 2px 0 rgba(0,0,0,.06); overflow: hidden; }
+            .vis-card-title { margin: 0; padding: .75rem 1.5rem; font-size: .8125rem; font-weight: 600; color: #1a202c; border-bottom: 1px solid #edf2f7; word-break: break-word; }
+            .vis-headline { padding: 1rem 1.5rem; }
+            .vis-error-name { display: inline-block; font-size: .75rem; font-weight: 700; text-transform: uppercase; letter-spacing: .05em; color: #e53e3e; }
+            .vis-error-message { margin: .5rem 0 0; font-size: 1rem; color: #1a202c; word-break: break-word; }
+            .vis-codeframe, .vis-solution-body { margin: 0; padding: 1rem 1.5rem; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: .8125rem; line-height: 1.6; color: #2d3748; white-space: pre; overflow-x: auto; }
+            .vis-solution-body { white-space: pre-wrap; word-break: break-word; }
+            .vis-frames { margin: 0; padding: 0; list-style: none; }
+            .vis-frame { display: flex; flex-direction: column; padding: .5rem 1.5rem; border-bottom: 1px solid #edf2f7; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: .8125rem; }
+            .vis-frame:last-child { border-bottom: 0; }
+            .vis-frame-method { color: #1a202c; font-weight: 600; }
+            .vis-frame-loc { color: #718096; word-break: break-word; }
+            @media (prefers-color-scheme: dark) {
+                .vis-card { background: #2d3748; }
+                .vis-card-title { color: #fff; border-bottom-color: #4a5568; }
+                .vis-error-message, .vis-codeframe, .vis-solution-body, .vis-frame-method { color: #e2e8f0; }
+                .vis-frame { border-bottom-color: #4a5568; }
+                .vis-frame-loc { color: #a0aec0; }
+            }`,D=(e={})=>async(r,t,o)=>{u(o,r),o.setHeader("content-type","text/html; charset=utf-8");const n=x(o.statusCode)||"Error",i=e.cspNonce?` nonce="${e.cspNonce}"`:"",{expose:s}=r,c=s?await F(r,{allowRemoteSources:e.allowRemoteSources,linesAbove:e.linesAbove,linesBelow:e.linesBelow,solutionFinders:e.solutionFinders}):"";if(e.errorPage){const a=typeof e.errorPage=="function"?await e.errorPage({error:r,reasonPhrase:n,request:t,response:o,statusCode:o.statusCode}):e.errorPage;if(a){o.end(a);return}}o.end(String.raw`<!DOCTYPE html>
 <html lang="en">
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width, initial-scale=1">
 
-        <title>${o}</title>
+        <title>${n}</title>
         <meta name="robots" content="noindex">
 
-        <style${a}>
+        <style${i}>
             /*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}a{background-color:transparent}code{font-family:monospace,monospace;font-size:1em}[hidden]{display:none}html{font-family:system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;line-height:1.5}*,:after,:before{box-sizing:border-box;border:0 solid #e2e8f0}a{color:inherit;text-decoration:inherit}code{font-family:Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}svg,video{display:block;vertical-align:middle}video{max-width:100%;height:auto}.bg-white{--bg-opacity:1;background-color:#fff;background-color:rgba(255,255,255,var(--bg-opacity))}.bg-gray-100{--bg-opacity:1;background-color:#f7fafc;background-color:rgba(247,250,252,var(--bg-opacity))}.border-gray-200{--border-opacity:1;border-color:#edf2f7;border-color:rgba(237,242,247,var(--border-opacity))}.border-gray-400{--border-opacity:1;border-color:#cbd5e0;border-color:rgba(203,213,224,var(--border-opacity))}.border-r{border-right-width:1px}.flex{display:flex}.grid{display:grid}.hidden{display:none}.items-center{align-items:center}.justify-center{justify-content:center}.font-semibold{font-weight:600}.h-5{height:1.25rem}.h-8{height:2rem}.h-16{height:4rem}.text-sm{font-size:.875rem}.text-lg{font-size:1.125rem}.leading-7{line-height:1.75rem}.mx-auto{margin-left:auto;margin-right:auto}.ml-1{margin-left:.25rem}.mt-2{margin-top:.5rem}.mr-2{margin-right:.5rem}.ml-2{margin-left:.5rem}.mt-4{margin-top:1rem}.ml-4{margin-left:1rem}.mt-8{margin-top:2rem}.ml-12{margin-left:3rem}.-mt-px{margin-top:-1px}.max-w-xl{max-width:36rem}.max-w-6xl{max-width:72rem}.min-h-screen{min-height:100vh}.overflow-hidden{overflow:hidden}.p-6{padding:1.5rem}.py-4{padding-top:1rem;padding-bottom:1rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.pt-8{padding-top:2rem}.fixed{position:fixed}.relative{position:relative}.top-0{top:0}.right-0{right:0}.shadow{box-shadow:0 1px 3px 0 rgba(0,0,0,.1),0 1px 2px 0 rgba(0,0,0,.06)}.text-center{text-align:center}.text-gray-200{--text-opacity:1;color:#edf2f7;color:rgba(237,242,247,var(--text-opacity))}.text-gray-300{--text-opacity:1;color:#e2e8f0;color:rgba(226,232,240,var(--text-opacity))}.text-gray-400{--text-opacity:1;color:#cbd5e0;color:rgba(203,213,224,var(--text-opacity))}.text-gray-500{--text-opacity:1;color:#a0aec0;color:rgba(160,174,192,var(--text-opacity))}.text-gray-600{--text-opacity:1;color:#718096;color:rgba(113,128,150,var(--text-opacity))}.text-gray-700{--text-opacity:1;color:#4a5568;color:rgba(74,85,104,var(--text-opacity))}.text-gray-900{--text-opacity:1;color:#1a202c;color:rgba(26,32,44,var(--text-opacity))}.uppercase{text-transform:uppercase}.underline{text-decoration:underline}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.tracking-wider{letter-spacing:.05em}.w-5{width:1.25rem}.w-8{width:2rem}.w-auto{width:auto}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}@media (min-width:640px){.sm\:rounded-lg{border-radius:.5rem}.sm\:block{display:block}.sm\:items-center{align-items:center}.sm\:justify-start{justify-content:flex-start}.sm\:justify-between{justify-content:space-between}.sm\:h-20{height:5rem}.sm\:ml-0{margin-left:0}.sm\:px-6{padding-left:1.5rem;padding-right:1.5rem}.sm\:pt-0{padding-top:0}.sm\:text-left{text-align:left}.sm\:text-right{text-align:right}}@media (min-width:768px){.md\:border-t-0{border-top-width:0}.md\:border-l{border-left-width:1px}.md\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (min-width:1024px){.lg\:px-8{padding-left:2rem;padding-right:2rem}}@media (prefers-color-scheme:dark){.dark\:bg-gray-800{--bg-opacity:1;background-color:#2d3748;background-color:rgba(45,55,72,var(--bg-opacity))}.dark\:bg-gray-900{--bg-opacity:1;background-color:#1a202c;background-color:rgba(26,32,44,var(--bg-opacity))}.dark\:border-gray-700{--border-opacity:1;border-color:#4a5568;border-color:rgba(74,85,104,var(--border-opacity))}.dark\:text-white{--text-opacity:1;color:#fff;color:rgba(255,255,255,var(--text-opacity))}.dark\:text-gray-400{--text-opacity:1;color:#cbd5e0;color:rgba(203,213,224,var(--text-opacity))}}
         </style>
 
-        <style${a}>
+        <style${i}>
             body {
                 font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
             }
-        </style>
+        </style>${s?`
+        <style${i}>${I}
+        </style>`:""}
     </head>
     <body class="antialiased">
-        <div class="relative flex items-center justify-center min-h-screen bg-gray-100 dark:bg-gray-900">
+        <div class="relative flex items-center justify-center ${s?"pt-8":"min-h-screen"} bg-gray-100 dark:bg-gray-900">
             <div class="max-w-xl mx-auto sm:px-6 lg:px-8">
                 <div class="flex items-center justify-center">
                     <div class="px-6 text-lg text-gray-600 dark:text-gray-400 border-r border-gray-400 dark:border-gray-700 tracking-wider font-semibold">
-                        ${t.statusCode}
+                        ${o.statusCode}
                     </div>
 
                     <div class="ml-4 text-lg text-gray-600 dark:text-gray-400 uppercase tracking-wider">
-                        ${o}
+                        ${n}
                     </div>
                 </div>
             </div>
-        </div>
+        </div>${c}
     </body>
-</html>`)},"htmlErrorHandler");export{x as htmlErrorHandler};
+</html>`)};export{D as htmlErrorHandler};

package/dist/error-handler/json-error-handler.d.ts

@@ -1,14 +1,15 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ErrorHandler } from "./types.d.d.ts";
-export type JsonErrorBody = Record<string, unknown> | unknown[];
-export type JsonErrorFormatter = (parameters: {
-    error: Error;
-    reasonPhrase: string;
-    request: IncomingMessage;
-    response: ServerResponse;
-    statusCode: number;
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+type JsonErrorBody = Record<string, unknown> | unknown[];
+type JsonErrorFormatter = (parameters: {
+  error: Error;
+  reasonPhrase: string;
+  request: IncomingMessage;
+  response: ServerResponse;
+  statusCode: number;
 }) => JsonErrorBody | Promise<JsonErrorBody>;
-export type JsonErrorHandlerOptions = {
-    formatter?: JsonErrorFormatter;
+type JsonErrorHandlerOptions = {
+  formatter?: JsonErrorFormatter;
 };
-export declare const jsonErrorHandler: (options?: JsonErrorHandlerOptions) => ErrorHandler;
+declare const jsonErrorHandler: (options?: JsonErrorHandlerOptions) => ErrorHandler;
+export { JsonErrorBody, JsonErrorFormatter, JsonErrorHandlerOptions, jsonErrorHandler };

package/dist/error-handler/json-error-handler.js

@@ -1 +1 @@
-var p=Object.defineProperty;var a=(e,r)=>p(e,"name",{value:r,configurable:!0});import{getReasonPhrase as u}from"http-status-codes";import{a as f}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{s as n}from"../packem_shared/send-json-Cedv8-Bt.js";import{a as i}from"../packem_shared/set-error-headers-DT9rVGtW.js";var g=Object.defineProperty,l=a((e,r)=>g(e,"name",{value:r,configurable:!0}),"n");const h=l((e={})=>async(r,m,s)=>{f(s,r),i(s,r);const{statusCode:o}=s,t=u(o)||"An error occurred";if(e.formatter){const c=await e.formatter({error:r,reasonPhrase:t,request:m,response:s,statusCode:o});n(s,c);return}const{expose:d}=r;n(s,{message:r.message||t,error:t,statusCode:o,...d?{stack:r.stack}:{}})},"jsonErrorHandler");export{h as jsonErrorHandler};
+import{getReasonPhrase as p}from"http-status-codes";import{a as f}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as a}from"../packem_shared/send-json-fz8r6NBW.js";import{o as i}from"../packem_shared/set-error-headers-g9hns3cZ.js";const h=(t={})=>async(r,m,e)=>{f(e,r),i(e,r);const{statusCode:s}=e,o=p(s)||"An error occurred";if(t.formatter){const c=await t.formatter({error:r,reasonPhrase:o,request:m,response:e,statusCode:s});a(e,c);return}const{expose:n}=r;a(e,{message:r.message||o,error:o,statusCode:s,...n?{stack:r.stack}:{}})};export{h as jsonErrorHandler};

package/dist/error-handler/jsonapi-error-handler.d.ts

@@ -1,3 +1,4 @@
-import type { ErrorHandler } from "./types.d.d.ts";
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+import 'node:http';
 declare const jsonapiErrorHandler: ErrorHandler;
-export default jsonapiErrorHandler;
+export { jsonapiErrorHandler as default };

package/dist/error-handler/jsonapi-error-handler.js

@@ -1 +1 @@
-var u=Object.defineProperty;var i=(e,s)=>u(e,"name",{value:s,configurable:!0});import{isHttpError as f}from"http-errors";import{getReasonPhrase as n}from"http-status-codes";import a from"ts-japi";import{a as l}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{s as t}from"../packem_shared/send-json-Cedv8-Bt.js";import{a as c}from"../packem_shared/set-error-headers-DT9rVGtW.js";var g=Object.defineProperty,C=i((e,s)=>g(e,"name",{value:s,configurable:!0}),"n");const d="An error occurred",H=C((e,s,r)=>{if(l(r,e),c(r,e),e instanceof a.JapiError||a.JapiError.isLikeJapiError(e)){const o=new a.ErrorSerializer;t(r,o.serialize(e))}else if(f(e)){const o="statusCode"in e&&typeof e.statusCode=="number"?e.statusCode:"status"in e&&typeof e.status=="number"?e.status:r.statusCode,m="title"in e&&typeof e.title=="string"?e.title:void 0,p="message"in e&&typeof e.message=="string"?e.message:"";t(r,{errors:[{code:o??r.statusCode,title:m||n(o)||d,detail:p}]})}else{const{message:o}=e;t(r,{errors:[{code:"500",title:n(r.statusCode)||d,detail:o}]})}},"jsonapiErrorHandler");export{H as default};
+import{isHttpError as f}from"http-errors";import{getReasonPhrase as m}from"http-status-codes";import i from"ts-japi";import{a as p}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as t}from"../packem_shared/send-json-fz8r6NBW.js";import{o as l}from"../packem_shared/set-error-headers-g9hns3cZ.js";const u=(e,a)=>"statusCode"in e&&typeof e.statusCode=="number"?e.statusCode:"status"in e&&typeof e.status=="number"?e.status:a,J=(e,a,r)=>{if(p(r,e),l(r,e),e instanceof i.JapiError||i.JapiError.isLikeJapiError(e)){const o=new i.ErrorSerializer;t(r,o.serialize(e))}else if(f(e)){const o=u(e,r.statusCode),s="title"in e&&typeof e.title=="string"?e.title:void 0,n="message"in e&&typeof e.message=="string"?e.message:"";t(r,{errors:[{code:o,title:s??m(o),detail:n}]})}else{const{message:o}=e,{statusCode:s}=r;t(r,{errors:[{code:s,title:m(s),detail:o}]})}};export{J as default};

package/dist/error-handler/jsonp-error-handler.d.ts

@@ -1,15 +1,16 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ErrorHandler } from "./types.d.d.ts";
-export type JsonpErrorBody = Record<string, unknown> | unknown[];
-export type JsonpErrorFormatter = (parameters: {
-    error: Error;
-    reasonPhrase: string;
-    request: IncomingMessage;
-    response: ServerResponse;
-    statusCode: number;
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+declare const jsonpErrorHandler: (options?: JsonpErrorHandlerOptions) => ErrorHandler;
+type JsonpErrorBody = Record<string, unknown> | unknown[];
+type JsonpErrorFormatter = (parameters: {
+  error: Error;
+  reasonPhrase: string;
+  request: IncomingMessage;
+  response: ServerResponse;
+  statusCode: number;
 }) => JsonpErrorBody | Promise<JsonpErrorBody>;
-export type JsonpErrorHandlerOptions = {
-    callbackParamName?: string;
-    formatter?: JsonpErrorFormatter;
+type JsonpErrorHandlerOptions = {
+  callbackParamName?: string;
+  formatter?: JsonpErrorFormatter;
 };
-export declare const jsonpErrorHandler: (options?: JsonpErrorHandlerOptions) => ErrorHandler;
+export { JsonpErrorBody, JsonpErrorFormatter, JsonpErrorHandlerOptions, jsonpErrorHandler };

package/dist/error-handler/jsonp-error-handler.js

@@ -1 +1 @@
-var i=Object.defineProperty;var n=(e,a)=>i(e,"name",{value:a,configurable:!0});import{getReasonPhrase as f}from"http-status-codes";import{a as u}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{a as h}from"../packem_shared/set-error-headers-DT9rVGtW.js";var g=Object.defineProperty,b=n((e,a)=>g(e,"name",{value:a,configurable:!0}),"c");const k="callback",C=b((e={})=>async(a,c,t)=>{u(t,a),h(t,a);const{statusCode:r}=t,s=f(r)||"An error occurred",l=new URL(c.url??"http://localhost","http://localhost"),p=e.callbackParamName||k,m=l.searchParams.get(p)||"callback";let o;if(e.formatter)o=await e.formatter({error:a,reasonPhrase:s,request:c,response:t,statusCode:r});else{const{expose:d}=a;o={message:a.message||s,error:s,statusCode:r,...d?{stack:a.stack}:{}}}t.setHeader("content-type","application/javascript; charset=utf-8"),t.end(`${m}(${JSON.stringify(o)});`)},"jsonpErrorHandler");export{C as jsonpErrorHandler};
+import{getReasonPhrase as f}from"http-status-codes";import{a as h}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as d}from"../packem_shared/set-error-headers-g9hns3cZ.js";const c="callback",g=/^[A-Za-z_$][\w$.]*$/u,k=(s={})=>async(e,l,t)=>{h(t,e),d(t,e);const{statusCode:o}=t,r=f(o),p=new URL(l.url??"http://localhost","http://localhost"),i=s.callbackParamName??c;let a=p.searchParams.get(i)??c,n;if(s.formatter)n=await s.formatter({error:e,reasonPhrase:r,request:l,response:t,statusCode:o});else{const{expose:u}=e;n={message:e.message||r,error:r,statusCode:o,...u?{stack:e.stack}:{}}}(a.length>64||!g.test(a))&&(a=c),t.setHeader("content-type","application/javascript; charset=utf-8"),t.setHeader("x-content-type-options","nosniff");const m=JSON.stringify(n).replaceAll("\u2028",String.raw`\u2028`).replaceAll("\u2029",String.raw`\u2029`);t.end(`/**/ typeof ${a} === 'function' && ${a}(${m});`)};export{k as jsonpErrorHandler};

package/dist/error-handler/problem-error-handler.d.ts

@@ -1,7 +1,8 @@
-import type { ErrorHandler } from "./types.d.d.ts";
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+import 'node:http';
 /**
- * Normalizes errors according to the API Problem spec (RFC 7807).
- * @see https://tools.ietf.org/html/rfc7807
- */
+* Normalizes errors according to the API Problem spec (RFC 7807).
+* @see https://tools.ietf.org/html/rfc7807
+*/
 declare const problemErrorHandler: ErrorHandler;
-export default problemErrorHandler;
+export { problemErrorHandler as default };

package/dist/error-handler/problem-error-handler.js

@@ -1 +1 @@
-var c=Object.defineProperty;var i=(e,o)=>c(e,"name",{value:o,configurable:!0});import{isHttpError as y}from"http-errors";import{getReasonPhrase as p}from"http-status-codes";import{a as b}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{s as n}from"../packem_shared/send-json-Cedv8-Bt.js";import{a as C}from"../packem_shared/set-error-headers-DT9rVGtW.js";var v=Object.defineProperty,g=i((e,o)=>v(e,"name",{value:o,configurable:!0}),"i");const d="about:blank",u="An error occurred",R=g((e,o,t)=>{const{message:a,stack:r}=e;if(y(e)){const l="expose"in e?e.expose:void 0,s="statusCode"in e&&typeof e.statusCode=="number"?e.statusCode:"status"in e&&typeof e.status=="number"?e.status:t.statusCode,m="title"in e&&typeof e.title=="string"?e.title:void 0,f="type"in e&&typeof e.type=="string"?e.type:void 0;t.statusCode=s,C(t,e),n(t,{type:f||d,title:m||p(s)||u,status:s,detail:a,...l?{trace:r}:{}},"application/problem+json")}else b(t,e),n(t,{type:d,title:p(t.statusCode)||u,status:t.statusCode,detail:a,...e.expose?{trace:r}:{}},"application/problem+json")},"problemErrorHandler");export{R as default};
+import{isHttpError as d}from"http-errors";import{getReasonPhrase as p}from"http-status-codes";import{a as f}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as r}from"../packem_shared/send-json-fz8r6NBW.js";import{o as c}from"../packem_shared/set-error-headers-g9hns3cZ.js";const n="about:blank",y=(t,s)=>"statusCode"in t&&typeof t.statusCode=="number"?t.statusCode:"status"in t&&typeof t.status=="number"?t.status:s,$=(t,s,e)=>{const{message:a,stack:i}=t;if(d(t)){const m="expose"in t?t.expose:void 0,o=y(t,e.statusCode),u="title"in t&&typeof t.title=="string"?t.title:void 0,l="type"in t&&typeof t.type=="string"?t.type:void 0;e.statusCode=o,c(e,t),r(e,{type:l??n,title:u??p(o),status:o,detail:a,...m?{trace:i}:{}},"application/problem+json")}else f(e,t),r(e,{type:n,title:p(e.statusCode),status:e.statusCode,detail:a,...t.expose?{trace:i}:{}},"application/problem+json")};export{$ as default};

package/dist/error-handler/text-error-handler.d.ts

@@ -1,13 +1,14 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ErrorHandler } from "./types.d.d.ts";
-export type TextErrorFormatter = (parameters: {
-    error: Error;
-    reasonPhrase: string;
-    request: IncomingMessage;
-    response: ServerResponse;
-    statusCode: number;
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+type TextErrorFormatter = (parameters: {
+  error: Error;
+  reasonPhrase: string;
+  request: IncomingMessage;
+  response: ServerResponse;
+  statusCode: number;
 }) => string | Promise<string>;
-export type TextErrorHandlerOptions = {
-    formatter?: TextErrorFormatter;
+type TextErrorHandlerOptions = {
+  formatter?: TextErrorFormatter;
 };
-export declare const textErrorHandler: (options?: TextErrorHandlerOptions) => ErrorHandler;
+declare const textErrorHandler: (options?: TextErrorHandlerOptions) => ErrorHandler;
+export { TextErrorFormatter, TextErrorHandlerOptions, textErrorHandler };

package/dist/error-handler/text-error-handler.js

@@ -1,3 +1,3 @@
-var f=Object.defineProperty;var d=(r,e)=>f(r,"name",{value:e,configurable:!0});import{getReasonPhrase as i}from"http-status-codes";import{a as u}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{a as l}from"../packem_shared/set-error-headers-DT9rVGtW.js";var x=Object.defineProperty,v=d((r,e)=>x(r,"name",{value:e,configurable:!0}),"m");const E=v((r={})=>async(e,c,t)=>{u(t,e),l(t,e);const{statusCode:o}=t,a=i(o)||"Error";if(t.setHeader("content-type","text/plain; charset=utf-8"),r.formatter){const p=await r.formatter({error:e,reasonPhrase:a,request:c,response:t,statusCode:o});t.end(p);return}const s=e.message||a,{expose:m}=e,n=m?e.stack:void 0;t.end(n?`${s}
+import{getReasonPhrase as i}from"http-status-codes";import{a as d}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as f}from"../packem_shared/set-error-headers-g9hns3cZ.js";const h=(o={})=>async(e,m,t)=>{d(t,e),f(t,e);const{statusCode:r}=t,s=i(r)||"Error";if(t.setHeader("content-type","text/plain; charset=utf-8"),o.formatter){const c=await o.formatter({error:e,reasonPhrase:s,request:m,response:t,statusCode:r});t.end(c);return}const a=e.message||s,{expose:p}=e,n=p?e.stack:void 0;t.end(n?`${a}
 
-${n}`:s)},"textErrorHandler");export{E as textErrorHandler};
+${n}`:a)};export{h as textErrorHandler};

package/dist/error-handler/xml-error-handler.d.ts

@@ -1,26 +1,27 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ErrorHandler } from "./types.d.d.ts";
-export type XmlErrorBody = Record<string, unknown> | unknown[];
-export type XmlErrorFormatter = (parameters: {
-    error: Error;
-    reasonPhrase: string;
-    request: IncomingMessage;
-    response: ServerResponse;
-    statusCode: number;
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { E as ErrorHandler } from "../packem_shared/types.d-Btzbxdod.js";
+type XmlErrorBody = Record<string, unknown> | unknown[];
+type XmlErrorFormatter = (parameters: {
+  error: Error;
+  reasonPhrase: string;
+  request: IncomingMessage;
+  response: ServerResponse;
+  statusCode: number;
 }) => XmlErrorBody | Promise<XmlErrorBody>;
-export type ToXmlOptions = {
-    attributeExplicitTrue?: boolean;
-    attributeFilter?: (key: string, value: unknown) => boolean;
-    attributeReplacements?: Record<string, string>;
-    contentMap?: (content: string) => string;
-    contentReplacements?: Record<string, string>;
-    header?: string | boolean;
-    indent?: string;
-    selfCloseTags?: boolean;
+type ToXmlOptions = {
+  attributeExplicitTrue?: boolean;
+  attributeFilter?: (key: string, value: unknown) => boolean;
+  attributeReplacements?: Record<string, string>;
+  contentMap?: (content: string) => string;
+  contentReplacements?: Record<string, string>;
+  header?: string | boolean;
+  indent?: string;
+  selfCloseTags?: boolean;
 };
-export type XmlErrorHandlerOptions = {
-    formatter?: XmlErrorFormatter;
-    toXml?: ToXmlOptions;
-    xmlHeader?: boolean;
+type XmlErrorHandlerOptions = {
+  formatter?: XmlErrorFormatter;
+  toXml?: ToXmlOptions;
+  xmlHeader?: boolean;
 };
-export declare const xmlErrorHandler: (options?: XmlErrorHandlerOptions) => ErrorHandler;
+declare const xmlErrorHandler: (options?: XmlErrorHandlerOptions) => ErrorHandler;
+export { ToXmlOptions, XmlErrorBody, XmlErrorFormatter, XmlErrorHandlerOptions, xmlErrorHandler };

package/dist/error-handler/xml-error-handler.js

@@ -1 +1 @@
-var c=Object.defineProperty;var l=(t,e)=>c(t,"name",{value:e,configurable:!0});import{getReasonPhrase as p}from"http-status-codes";import{toXML as u}from"jstoxml";import{a as d}from"../packem_shared/add-status-code-to-response-BE6paXjR.js";import{a as X}from"../packem_shared/set-error-headers-DT9rVGtW.js";var f=Object.defineProperty,b=l((t,e)=>f(t,"name",{value:e,configurable:!0}),"l");const h=b((t={})=>async(e,n,o)=>{d(o,e),X(o,e);const{statusCode:r}=o,a=p(r)||"An error occurred";let s;if(t.formatter)s=await t.formatter({error:e,reasonPhrase:a,request:n,response:o,statusCode:r});else{const{expose:i}=e;s={error:{statusCode:r,name:a,message:e.message||a,...i?{stack:e.stack}:{}}}}const m=u(s,{header:t.toXml?.header??t.xmlHeader??!0,indent:t.toXml?.indent??"  ",...t.toXml?.attributeReplacements?{attributeReplacements:t.toXml.attributeReplacements}:{},...t.toXml?.attributeFilter?{attributeFilter:t.toXml.attributeFilter}:{},...t.toXml?.attributeExplicitTrue===void 0?{}:{attributeExplicitTrue:t.toXml.attributeExplicitTrue},...t.toXml?.contentMap?{contentMap:t.toXml.contentMap}:{},...t.toXml?.contentReplacements?{contentReplacements:t.toXml.contentReplacements}:{},...t.toXml?.selfCloseTags===void 0?{}:{selfCloseTags:t.toXml.selfCloseTags}});o.setHeader("content-type","application/xml; charset=utf-8"),o.end(m)},"xmlErrorHandler");export{h as xmlErrorHandler};
+import{getReasonPhrase as i}from"http-status-codes";import{toXML as c}from"jstoxml";import{a as p}from"../packem_shared/add-status-code-to-response-DwELM1q2.js";import{o as u}from"../packem_shared/set-error-headers-g9hns3cZ.js";const x=(t={})=>async(e,l,o)=>{p(o,e),u(o,e);const{statusCode:r}=o,a=i(r)||"An error occurred";let s;if(t.formatter)s=await t.formatter({error:e,reasonPhrase:a,request:l,response:o,statusCode:r});else{const{expose:m}=e;s={error:{statusCode:r,name:a,message:e.message||a,...m?{stack:e.stack}:{}}}}const n=c(s,{header:t.toXml?.header??t.xmlHeader??!0,indent:t.toXml?.indent??"  ",...t.toXml?.attributeReplacements?{attributeReplacements:t.toXml.attributeReplacements}:{},...t.toXml?.attributeFilter?{attributeFilter:t.toXml.attributeFilter}:{},...t.toXml?.attributeExplicitTrue===void 0?{}:{attributeExplicitTrue:t.toXml.attributeExplicitTrue},...t.toXml?.contentMap?{contentMap:t.toXml.contentMap}:{},...t.toXml?.contentReplacements?{contentReplacements:t.toXml.contentReplacements}:{},...t.toXml?.selfCloseTags===void 0?{}:{selfCloseTags:t.toXml.selfCloseTags}});o.setHeader("content-type","application/xml; charset=utf-8"),o.end(n)};export{x as xmlErrorHandler};

package/dist/handler/cli-handler.d.ts

@@ -1,4 +1,27 @@
-import type { BaseCliOptions } from "../../../../../shared/utils/cli-error-builder.d.ts";
-export type { BaseCliOptions, CliHandlerOptions } from "../../../../../shared/utils/cli-error-builder.d.ts";
-export declare const ansiHandler: (error: Error, options?: BaseCliOptions) => Promise<string>;
-export { terminalOutput as cliHandler } from "../../../../../shared/utils/cli-error-builder.d.ts";
+import { RenderErrorOptions } from '@visulima/error/error';
+import { SolutionFinder } from '@visulima/error/solution';
+type CliLogger = {
+  error: (...arguments_: unknown[]) => void;
+  log: (...arguments_: unknown[]) => void;
+};
+type ColorizeMethod = (value: string) => string;
+type BaseCliOptions = {
+  solutionTitle?: string;
+  solutionFinders?: SolutionFinder[];
+  debug?: boolean;
+} & Partial<Omit<RenderErrorOptions, "color">> & {
+  color?: {
+    codeFrame?: RenderErrorOptions["color"];
+    boxen?: {
+      headerTextColor?: ColorizeMethod;
+      textColor?: ColorizeMethod;
+      borderColor?: ColorizeMethod;
+    };
+  };
+};
+type CliHandlerOptions = BaseCliOptions & {
+  logger?: CliLogger;
+};
+declare const terminalOutput: (error: Error, options?: CliHandlerOptions) => Promise<void>;
+declare const ansiHandler: (error: Error, options?: BaseCliOptions) => Promise<string>;
+export { type BaseCliOptions, type CliHandlerOptions, ansiHandler, terminalOutput as cliHandler };

package/dist/handler/cli-handler.js

@@ -1,3 +1,3 @@
-var o=Object.defineProperty;var a=(r,e)=>o(r,"name",{value:e,configurable:!0});import{buildOutput as i}from"../packem_shared/cliHandler-CeQ8tsGj.js";import{terminalOutput as f}from"../packem_shared/cliHandler-CeQ8tsGj.js";var u=Object.defineProperty,l=a((r,e)=>u(r,"name",{value:e,configurable:!0}),"o");const d=l(async(r,e={})=>{const{errorAnsi:t,solutionBox:n}=await i(r,e);return n===void 0?t:`${t}
+import{buildOutput as n}from"../packem_shared/cliHandler-BGq-ckC0.js";import{terminalOutput as l}from"../packem_shared/cliHandler-BGq-ckC0.js";const e=async(o,i={})=>{const{errorAnsi:r,solutionBox:t}=await n(o,i);return t===void 0?r:`${r}
 
-${n}`},"ansiHandler");export{d as ansiHandler,f as cliHandler};
+${t}`};export{e as ansiHandler,l as cliHandler};