@visulima/error-handler 2.0.0-alpha.9 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/CHANGELOG.md +453 -0
  2. package/LICENSE.md +698 -136
  3. package/README.md +38 -23
  4. package/dist/error-handler/fetch-utils.d.ts +3 -0
  5. package/dist/error-handler/fetch-utils.js +1 -0
  6. package/dist/error-handler/html-error-handler.d.ts +42 -12
  7. package/dist/error-handler/html-error-handler.js +50 -10
  8. package/dist/error-handler/json-error-handler.d.ts +13 -12
  9. package/dist/error-handler/json-error-handler.js +1 -1
  10. package/dist/error-handler/jsonapi-error-handler.d.ts +3 -2
  11. package/dist/error-handler/jsonapi-error-handler.js +1 -1
  12. package/dist/error-handler/jsonp-error-handler.d.ts +14 -13
  13. package/dist/error-handler/jsonp-error-handler.js +1 -1
  14. package/dist/error-handler/problem-error-handler.d.ts +3 -2
  15. package/dist/error-handler/problem-error-handler.js +1 -1
  16. package/dist/error-handler/text-error-handler.d.ts +12 -11
  17. package/dist/error-handler/text-error-handler.js +2 -2
  18. package/dist/error-handler/xml-error-handler.d.ts +24 -23
  19. package/dist/error-handler/xml-error-handler.js +1 -1
  20. package/dist/handler/cli-handler.d.ts +27 -4
  21. package/dist/handler/cli-handler.js +2 -2
  22. package/dist/handler/http/create-error-middleware.d.ts +32 -0
  23. package/dist/handler/http/create-error-middleware.js +1 -0
  24. package/dist/handler/http/fetch-handler.d.ts +9 -7
  25. package/dist/handler/http/fetch-handler.js +1 -1
  26. package/dist/handler/http/node-handler.d.ts +9 -8
  27. package/dist/handler/http/node-handler.js +1 -1
  28. package/dist/index.d.ts +20 -14
  29. package/dist/index.js +1 -1
  30. package/dist/packem_shared/cliHandler-SiB_2eYh.js +35 -0
  31. package/dist/packem_shared/createNegotiatedErrorHandler-B5QZvIsI.js +1 -0
  32. package/dist/packem_shared/extractStatusCode-D0UOgNnr.js +1 -0
  33. package/dist/packem_shared/fetchCreateNegotiatedErrorHandler-BZIDeXwJ.js +1 -0
  34. package/dist/packem_shared/fetchHtmlErrorHandler-C_tTx5yo.js +1 -0
  35. package/dist/packem_shared/get-file-source-DizRP9BY.js +1 -0
  36. package/dist/packem_shared/mock-server-response-B0aq8b_2.js +1 -0
  37. package/dist/packem_shared/safe-reason-phrase-DgnEIVUq.js +1 -0
  38. package/dist/packem_shared/send-json-fz8r6NBW.js +1 -0
  39. package/dist/packem_shared/sendFetchJson-BNmfrMYp.js +1 -0
  40. package/dist/packem_shared/set-error-headers-g9hns3cZ.js +1 -0
  41. package/dist/packem_shared/types.d-Btzbxdod.d.ts +13 -0
  42. package/dist/packem_shared/with-expose-B0GLDHH8.js +1 -0
  43. package/package.json +49 -46
  44. package/dist/error-handler/create-negotiated-error-handler.d.ts +0 -4
  45. package/dist/error-handler/fetch-create-negotiated-error-handler.d.ts +0 -3
  46. package/dist/error-handler/fetch-html-error-handler.d.ts +0 -3
  47. package/dist/error-handler/utils/add-status-code-to-response.d.ts +0 -2
  48. package/dist/error-handler/utils/send-json.d.ts +0 -8
  49. package/dist/error-handler/utils/set-error-headers.d.ts +0 -3
  50. package/dist/packem_shared/add-status-code-to-response-BE6paXjR.js +0 -1
  51. package/dist/packem_shared/cliHandler-CeQ8tsGj.js +0 -1
  52. package/dist/packem_shared/createNegotiatedErrorHandler-BLks0_Ak.js +0 -1
  53. package/dist/packem_shared/send-json-Cedv8-Bt.js +0 -1
  54. package/dist/packem_shared/set-error-headers-DT9rVGtW.js +0 -1
@@ -0,0 +1,32 @@
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { HtmlErrorHandlerOptions } from "../../error-handler/html-error-handler.js";
3
+ import { a as ErrorHandlers } from "../../packem_shared/types.d-Btzbxdod.js";
4
+ import '@visulima/error/solution';
5
+ type ErrorMiddlewareOptions = HtmlErrorHandlerOptions & {
6
+ extraHandlers?: ErrorHandlers;
7
+ /** Callback to handle error logging. */
8
+ onError?: (error: Error, request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
9
+ /** Include stack traces in responses. Defaults to `NODE_ENV !== "production"`. */
10
+ showTrace?: boolean;
11
+ };
12
+ type ErrorMiddleware = (error: Error, request: IncomingMessage, response: ServerResponse, next?: (error?: unknown) => void) => Promise<void>;
13
+ /**
14
+ * Express/Connect-style error middleware.
15
+ *
16
+ * Unlike {@link nodeHandler}, which takes the error at construction time and so
17
+ * has to be rebuilt inside every `catch` block, this returns a four-argument
18
+ * error middleware you register once:
19
+ *
20
+ * ```ts
21
+ * import { createErrorMiddleware } from "@visulima/error-handler";
22
+ *
23
+ * app.use(createErrorMiddleware({ showTrace: "production" !== "production" }));
24
+ * ```
25
+ *
26
+ * The returned function matches the Express/Connect `(err, req, res, next)`
27
+ * signature. If the response has already started streaming
28
+ * (`response.headersSent`), it delegates to `next(error)` so the framework's
29
+ * default handler can close the connection rather than double-writing.
30
+ */
31
+ declare const createErrorMiddleware: (options?: ErrorMiddlewareOptions) => ErrorMiddleware;
32
+ export { type ErrorMiddleware, type ErrorMiddlewareOptions, createErrorMiddleware as default };
@@ -0,0 +1 @@
1
+ import n from"./node-handler.js";const c=(r={})=>async(t,i,a,e)=>{if(a.headersSent){e&&e(t);return}await n(t,r)(i,a)};export{c as default};
@@ -1,8 +1,10 @@
1
- import type { HtmlErrorHandlerOptions } from "../../error-handler/html-error-handler.d.ts";
2
- import type { FetchErrorHandlers } from "../../error-handler/types.d.d.ts";
1
+ import { HtmlErrorHandlerOptions } from "../../error-handler/html-error-handler.js";
2
+ import { F as FetchErrorHandlers } from "../../packem_shared/types.d-Btzbxdod.js";
3
+ import 'node:http';
4
+ import '@visulima/error/solution';
3
5
  declare const fetchHandler: (error: Error, options?: HtmlErrorHandlerOptions & {
4
- extraHandlers?: FetchErrorHandlers;
5
- onError?: (error: Error, request: Request) => void | Promise<void>;
6
- showTrace?: boolean;
7
- }) => Promise<(request: Request) => Promise<Response>>;
8
- export default fetchHandler;
6
+ extraHandlers?: FetchErrorHandlers;
7
+ onError?: (error: Error, request: Request) => void | Promise<void>;
8
+ showTrace?: boolean;
9
+ }) => (request: Request) => Promise<Response>;
10
+ export { fetchHandler as default };
@@ -1 +1 @@
1
- var b=Object.defineProperty;var c=(r,e)=>b(r,"name",{value:e,configurable:!0});import{jsonErrorHandler as g}from"../../error-handler/json-error-handler.js";import w from"../../error-handler/jsonapi-error-handler.js";import{jsonpErrorHandler as y}from"../../error-handler/jsonp-error-handler.js";import u from"../../error-handler/problem-error-handler.js";import{textErrorHandler as H}from"../../error-handler/text-error-handler.js";import{xmlErrorHandler as v}from"../../error-handler/xml-error-handler.js";import{htmlErrorHandler as L}from"../../error-handler/html-error-handler.js";var j=Object.defineProperty,h=c((r,e)=>j(r,"name",{value:e,configurable:!0}),"a$1");class x{static{c(this,"j")}static{h(this,"MockServerResponse")}statusCode=200;headers={};_body="";setHeader(e,s){this.headers[e.toLowerCase()]=s}getHeader(e){return this.headers[e.toLowerCase()]}getHeaders(){return{...this.headers}}writeHead(e){this.statusCode=e}write(e){this._body+=e.toString()}end(e){e&&(this._body+=e.toString())}flushHeaders(){}}const k=h(r=>{if(!r)return"text/html";const e=r.toLowerCase();return e.includes("text/html")?"text/html":e.includes("application/vnd.api+json")?"application/vnd.api+json":e.includes("application/problem+json")?"application/problem+json":e.includes("application/json")?"application/json":e.includes("text/plain")?"text/plain":e.includes("application/javascript")||e.includes("text/javascript")?"application/javascript":e.includes("application/xml")||e.includes("text/xml")?"application/xml":"text/html"},"negotiateContentType"),d=h(r=>async(e,s)=>{const a={headers:Object.fromEntries(s.headers.entries()),method:s.method,url:s.url},i=new x;await r(e,a,i);const o={};for(const[l,n]of Object.entries(i.headers))o[l]=Array.isArray(n)?n.join(", "):String(n);return new Response(i._body,{headers:o,status:i.statusCode})},"adaptErrorHandlerToFetch"),C=h((r,e,s)=>async(a,i)=>{const o=i.headers.get("accept"),l=k(o);let n=s||d(u);if(l==="text/html"&&s)n=s;else switch(l){case"application/javascript":{n=d(y());break}case"application/json":{n=d(g());break}case"application/problem+json":{n=d(u);break}case"application/vnd.api+json":{n=d(w);break}case"application/xml":{n=d(v());break}case"text/plain":{n=d(H());break}}for(const{handler:p,regex:m}of r){const f=o??"";if(m.test(f)){n=p;break}}return a.expose=e,n(a,i)},"createFetchNegotiatedErrorHandler");var E=Object.defineProperty,t=c((r,e)=>E(r,"name",{value:e,configurable:!0}),"e");class S{static{c(this,"b")}static{t(this,"MockServerResponse")}statusCode=200;statusMessage="";headers={};headersSent=!1;writable=!0;finished=!1;writableEnded=!1;writableFinished=!1;writableHighWaterMark=16384;writableLength=0;destroyed=!1;writableCorked=0;readable=!1;readableHighWaterMark=16384;readableLength=0;errored=null;closed=!1;readableAborted=!1;readableDidRead=!1;readableEncoding=null;readableEnded=!1;readableFlowing=null;_events;_eventsCount=0;_maxListeners;body="";sendDate=!0;strictContentLength=!1;chunkedEncoding=!1;shouldKeepAlive=!0;useChunkedEncodingByDefault=!0;_hasBody=!0;_trailer="";connection=null;socket=null;setHeader(e,s){return this.headers[e.toLowerCase()]=s,this}getHeader(e){return this.headers[e.toLowerCase()]}getHeaders(){return{...this.headers}}getHeaderNames(){return Object.keys(this.headers)}hasHeader(e){return e.toLowerCase()in this.headers}removeHeader(e){return delete this.headers[e.toLowerCase()],this}writeHead(e,s,a){return this.statusCode=e,typeof s=="string"&&(this.statusMessage=s),typeof s=="object"&&(a=s),a&&Object.assign(this.headers,a),this}write(e){return this.body+=e.toString(),!0}end(e,s,a){return e&&(this.body+=e.toString()),this.finished=!0,this}flushHeaders(){this.headersSent=!0}addListener=t(()=>this,"addListener");on=t(()=>this,"on");once=t(()=>this,"once");removeListener=t(()=>this,"removeListener");off=t(()=>this,"off");removeAllListeners=t(()=>this,"removeAllListeners");setMaxListeners=t(()=>this,"setMaxListeners");getMaxListeners=t(()=>10,"getMaxListeners");listeners=t(()=>[],"listeners");rawListeners=t(()=>[],"rawListeners");emit=t(()=>!1,"emit");eventNames=t(()=>[],"eventNames");listenerCount=t(()=>0,"listenerCount");prependListener=t(()=>this,"prependListener");prependOnceListener=t(()=>this,"prependOnceListener");cork=t(()=>{},"cork");uncork=t(()=>{},"uncork");destroy=t(()=>this,"destroy");read=t(()=>null,"read");setEncoding=t(()=>this,"setEncoding");pause=t(()=>this,"pause");resume=t(()=>this,"resume");isPaused=t(()=>!1,"isPaused");destroySoon=t(()=>this,"destroySoon");pipe=t(()=>({}),"pipe");unpipe=t(()=>this,"unpipe");unshift=t(()=>{},"unshift");wrap=t(()=>this,"wrap");setTimeout=t(()=>this,"setTimeout");assignSocket=t(()=>{},"assignSocket");detachSocket=t(()=>{},"detachSocket");writeContinue=t(()=>{},"writeContinue");writeEarlyHints=t(()=>{},"writeEarlyHints")}const M=t((r={})=>{const e=L(r);return async(s,a)=>{const i={headers:Object.fromEntries(a.headers.entries()),method:a.method,url:a.url},o=new S;await e(s,i,o);const l=o.getHeader("content-type")||"text/html; charset=utf-8";return new Response(o.body,{headers:{"content-type":l,...o.headers},status:o.statusCode})}},"fetchHtmlErrorHandler");var O=Object.defineProperty,_=c((r,e)=>O(r,"name",{value:e,configurable:!0}),"t");const B=_(async(r,e={})=>{const s=M(e),a=C(e.extraHandlers??[],e.showTrace??!0,s);return async i=>(e?.onError&&await e.onError(r,i),a(r,i))},"fetchHandler");export{B as default};
1
+ import l from"../../packem_shared/fetchCreateNegotiatedErrorHandler-BZIDeXwJ.js";import i from"../../packem_shared/fetchHtmlErrorHandler-C_tTx5yo.js";const d=(o,r={})=>{const e=i(r),t=globalThis.process?.env,n=r.showTrace??(t===void 0?!1:t.NODE_ENV!=="production"),s=l(r.extraHandlers??[],n,e);return async a=>{if(r.onError)try{await r.onError(o,a)}catch(c){console.error(c)}return s(o,a)}};export{d as default};
@@ -1,9 +1,10 @@
1
- import type { IncomingMessage, ServerResponse } from "node:http";
2
- import type { HtmlErrorHandlerOptions } from "../../error-handler/html-error-handler.d.ts";
3
- import type { ErrorHandlers } from "../../error-handler/types.d.d.ts";
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { HtmlErrorHandlerOptions } from "../../error-handler/html-error-handler.js";
3
+ import { a as ErrorHandlers } from "../../packem_shared/types.d-Btzbxdod.js";
4
+ import '@visulima/error/solution';
4
5
  declare const nodeHandler: (error: Error, options?: HtmlErrorHandlerOptions & {
5
- extraHandlers?: ErrorHandlers;
6
- onError?: (error: Error, request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
7
- showTrace?: boolean;
8
- }) => Promise<(request: IncomingMessage, response: ServerResponse) => Promise<void>>;
9
- export default nodeHandler;
6
+ extraHandlers?: ErrorHandlers;
7
+ onError?: (error: Error, request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
8
+ showTrace?: boolean;
9
+ }) => (request: IncomingMessage, response: ServerResponse) => Promise<void>;
10
+ export { nodeHandler as default };
@@ -1 +1 @@
1
- var s=Object.defineProperty;var o=(a,r)=>s(a,"name",{value:r,configurable:!0});import c from"../../packem_shared/createNegotiatedErrorHandler-BLks0_Ak.js";import{htmlErrorHandler as m}from"../../error-handler/html-error-handler.js";var d=Object.defineProperty,i=o((a,r)=>d(a,"name",{value:r,configurable:!0}),"s");const v=i(async(a,r={})=>{const n=m(r),l=c(r.extraHandlers??[],r.showTrace??!0,n);return async(e,t)=>{r?.onError&&await r.onError(a,e,t),await l(a,e,t)}},"nodeHandler");export{v as default};
1
+ import i from"../../packem_shared/createNegotiatedErrorHandler-B5QZvIsI.js";import{htmlErrorHandler as d}from"../../error-handler/html-error-handler.js";const p=(r,o={})=>{const c=d(o),a=globalThis.process?.env,n=o.showTrace??(a===void 0?!1:a.NODE_ENV!=="production"),s=i(o.extraHandlers??[],n,c);return async(t,e)=>{if(o.onError)try{await o.onError(r,t,e)}catch(l){console.error(l)}await s(r,t,e)}};export{p as default};
package/dist/index.d.ts CHANGED
@@ -1,14 +1,20 @@
1
- export { default as createNegotiatedErrorHandler } from "./error-handler/create-negotiated-error-handler.d.ts";
2
- export type { HtmlErrorHandlerOptions } from "./error-handler/html-error-handler.d.ts";
3
- export { htmlErrorHandler } from "./error-handler/html-error-handler.d.ts";
4
- export type { JsonErrorBody, JsonErrorFormatter, JsonErrorHandlerOptions } from "./error-handler/json-error-handler.d.ts";
5
- export { jsonErrorHandler } from "./error-handler/json-error-handler.d.ts";
6
- export { default as jsonapiErrorHandler } from "./error-handler/jsonapi-error-handler.d.ts";
7
- export type { JsonpErrorBody, JsonpErrorFormatter, JsonpErrorHandlerOptions } from "./error-handler/jsonp-error-handler.d.ts";
8
- export { jsonpErrorHandler } from "./error-handler/jsonp-error-handler.d.ts";
9
- export { default as problemErrorHandler } from "./error-handler/problem-error-handler.d.ts";
10
- export type { TextErrorFormatter, TextErrorHandlerOptions } from "./error-handler/text-error-handler.d.ts";
11
- export { textErrorHandler } from "./error-handler/text-error-handler.d.ts";
12
- export type { ApiFormat, ErrorHandler, ErrorHandlers } from "./error-handler/types.d.d.ts";
13
- export type { ToXmlOptions, XmlErrorBody, XmlErrorFormatter, XmlErrorHandlerOptions } from "./error-handler/xml-error-handler.d.ts";
14
- export { xmlErrorHandler } from "./error-handler/xml-error-handler.d.ts";
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { a as ErrorHandlers, E as ErrorHandler, F as FetchErrorHandlers } from "./packem_shared/types.d-Btzbxdod.js";
3
+ export type { A as ApiFormat, b as FetchErrorHandler } from "./packem_shared/types.d-Btzbxdod.js";
4
+ import { HtmlErrorHandlerOptions } from "./error-handler/html-error-handler.js";
5
+ export { htmlErrorHandler } from "./error-handler/html-error-handler.js";
6
+ export { type JsonErrorBody, type JsonErrorFormatter, type JsonErrorHandlerOptions, jsonErrorHandler } from "./error-handler/json-error-handler.js";
7
+ export { default as jsonapiErrorHandler } from "./error-handler/jsonapi-error-handler.js";
8
+ export { type JsonpErrorBody, type JsonpErrorFormatter, type JsonpErrorHandlerOptions, jsonpErrorHandler } from "./error-handler/jsonp-error-handler.js";
9
+ export { default as problemErrorHandler } from "./error-handler/problem-error-handler.js";
10
+ export { type TextErrorFormatter, type TextErrorHandlerOptions, textErrorHandler } from "./error-handler/text-error-handler.js";
11
+ export { extractStatusCode, sendFetchJson } from "./error-handler/fetch-utils.js";
12
+ export { type ToXmlOptions, type XmlErrorBody, type XmlErrorFormatter, type XmlErrorHandlerOptions, xmlErrorHandler } from "./error-handler/xml-error-handler.js";
13
+ export { type ErrorMiddlewareOptions, default as createErrorMiddleware } from "./handler/http/create-error-middleware.js";
14
+ export { default as fetchHandler } from "./handler/http/fetch-handler.js";
15
+ export { default as nodeHandler } from "./handler/http/node-handler.js";
16
+ import '@visulima/error/solution';
17
+ declare const createNegotiatedErrorHandler: (errorHandlers: ErrorHandlers, showTrace: boolean, defaultHtmlHandler?: ErrorHandler) => (error: Error, request: IncomingMessage, response: ServerResponse) => Promise<void>;
18
+ declare const createFetchNegotiatedErrorHandler: (errorHandlers: FetchErrorHandlers, showTrace: boolean, defaultHtmlHandler?: (error: Error, request: Request) => Promise<Response>) => (error: Error, request: Request) => Promise<Response>;
19
+ declare const fetchHtmlErrorHandler: (options?: HtmlErrorHandlerOptions) => (error: Error, request: Request) => Promise<Response>;
20
+ export { type ErrorHandler, type ErrorHandlers, type FetchErrorHandlers, type HtmlErrorHandlerOptions, createNegotiatedErrorHandler, createFetchNegotiatedErrorHandler as fetchCreateNegotiatedErrorHandler, fetchHtmlErrorHandler };
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{default as e}from"./packem_shared/createNegotiatedErrorHandler-BLks0_Ak.js";import{htmlErrorHandler as t}from"./error-handler/html-error-handler.js";import{jsonErrorHandler as d}from"./error-handler/json-error-handler.js";import{default as m}from"./error-handler/jsonapi-error-handler.js";import{jsonpErrorHandler as p}from"./error-handler/jsonp-error-handler.js";import{default as E}from"./error-handler/problem-error-handler.js";import{textErrorHandler as s}from"./error-handler/text-error-handler.js";import{xmlErrorHandler as u}from"./error-handler/xml-error-handler.js";export{e as createNegotiatedErrorHandler,t as htmlErrorHandler,d as jsonErrorHandler,m as jsonapiErrorHandler,p as jsonpErrorHandler,E as problemErrorHandler,s as textErrorHandler,u as xmlErrorHandler};
1
+ import{default as o}from"./packem_shared/createNegotiatedErrorHandler-B5QZvIsI.js";import{default as a}from"./packem_shared/fetchCreateNegotiatedErrorHandler-BZIDeXwJ.js";import{default as f}from"./packem_shared/fetchHtmlErrorHandler-C_tTx5yo.js";import{htmlErrorHandler as m}from"./error-handler/html-error-handler.js";import{jsonErrorHandler as p}from"./error-handler/json-error-handler.js";import{default as s}from"./error-handler/jsonapi-error-handler.js";import{jsonpErrorHandler as u}from"./error-handler/jsonp-error-handler.js";import{default as c}from"./error-handler/problem-error-handler.js";import{textErrorHandler as i}from"./error-handler/text-error-handler.js";import{default as g}from"./packem_shared/extractStatusCode-D0UOgNnr.js";import{default as N}from"./packem_shared/sendFetchJson-BNmfrMYp.js";import{xmlErrorHandler as w}from"./error-handler/xml-error-handler.js";import{default as J}from"./handler/http/create-error-middleware.js";import{default as S}from"./handler/http/fetch-handler.js";import{default as q}from"./handler/http/node-handler.js";export{J as createErrorMiddleware,o as createNegotiatedErrorHandler,g as extractStatusCode,a as fetchCreateNegotiatedErrorHandler,S as fetchHandler,f as fetchHtmlErrorHandler,m as htmlErrorHandler,p as jsonErrorHandler,s as jsonapiErrorHandler,u as jsonpErrorHandler,q as nodeHandler,c as problemErrorHandler,N as sendFetchJson,i as textErrorHandler,w as xmlErrorHandler};