@emoyly/problem 5.0.7 → 6.0.0

package/esm/defaults/4xx.js

@@ -0,0 +1,148 @@
+// Source: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
+export const statusCodes = {
+    400: {
+        status: 400,
+        title: 'Bad Request',
+        type: '/errors/defaults/4xx/badrequest',
+    },
+    401: {
+        status: 401,
+        title: 'Unauthorized',
+        type: '/errors/defaults/4xx/unauthorized',
+    },
+    402: {
+        status: 402,
+        title: 'Payment Required',
+        type: '/errors/defaults/4xx/paymentrequired',
+    },
+    403: {
+        status: 403,
+        title: 'Forbidden',
+        type: '/errors/defaults/4xx/forbidden',
+    },
+    404: {
+        status: 404,
+        title: 'Not Found',
+        type: '/errors/defaults/4xx/notfound',
+    },
+    406: {
+        status: 406,
+        title: 'Not Acceptable',
+        type: 'errors/defaults/4xx/notacceptable'
+    },
+    405: {
+        status: 405,
+        title: 'Method Not Allowed',
+        type: 'errors/defaults/4xx/methodnotallowed'
+    },
+    407: {
+        status: 407,
+        title: 'Proxy Authentication Required (RFC 7235)',
+        type: 'errors/defaults/4xx/proxyauthenticationrequired'
+    },
+    408: {
+        status: 408,
+        title: 'Request Timeout',
+        type: 'errors/defaults/4xx/requesttimeout'
+    },
+    409: {
+        status: 409,
+        title: 'Conflict',
+        type: 'errors/defaults/4xx/conflict'
+    },
+    410: {
+        status: 410,
+        title: 'Gone',
+        type: 'errors/defaults/4xx/gone'
+    },
+    411: {
+        status: 411,
+        title: 'Length Required',
+        type: 'errors/defaults/4xx/lengthrequired'
+    },
+    412: {
+        status: 412,
+        title: 'Precondition Failed (RFC 7232)',
+        type: 'errors/defaults/4xx/preconditionfailed'
+    },
+    413: {
+        status: 413,
+        title: 'Payload Too Large (RFC 7231)',
+        type: 'errors/defaults/4xx/payloadtoolarge'
+    },
+    414: {
+        status: 414,
+        title: 'URI Too Long (RFC 7231)',
+        type: 'errors/defaults/4xx/uritoolong'
+    },
+    415: {
+        status: 415,
+        title: 'Unsupported Media Type (RFC 7231)',
+        type: 'errors/defaults/4xx/unsupportedmediatype'
+    },
+    416: {
+        status: 416,
+        title: 'Range Not Satisfiable (RFC 7233)',
+        type: 'errors/defaults/4xx/rangenotsatisfiable'
+    },
+    417: {
+        status: 417,
+        title: 'Expectation Failed',
+        type: 'errors/defaults/4xx/expectationfailed'
+    },
+    418: {
+        status: 418,
+        title: 'I\'m a teapot (RFC 2324, RFC 7168)',
+        type: 'errors/defaults/4xx/i\'mateapot'
+    },
+    421: {
+        status: 421,
+        title: 'Misdirected Request (RFC 7540)',
+        type: 'errors/defaults/4xx/misdirectedrequest'
+    },
+    422: {
+        status: 422,
+        title: 'Unprocessable Entity (WebDAV; RFC 4918)',
+        type: 'errors/defaults/4xx/unprocessableentity'
+    },
+    423: {
+        status: 423,
+        title: 'Locked (WebDAV; RFC 4918)',
+        type: 'errors/defaults/4xx/locked'
+    },
+    424: {
+        status: 424,
+        title: 'Failed Dependency (WebDAV; RFC 4918)',
+        type: 'errors/defaults/4xx/faileddependency'
+    },
+    425: {
+        status: 425,
+        title: 'Too Early (RFC 8470)',
+        type: 'errors/defaults/4xx/tooearly'
+    },
+    426: {
+        status: 426,
+        title: 'Upgrade Required',
+        type: 'errors/defaults/4xx/upgraderequired'
+    },
+    428: {
+        status: 428,
+        title: 'Precondition Required (RFC 6585)',
+        type: 'errors/defaults/4xx/preconditionrequired'
+    },
+    429: {
+        status: 429,
+        title: 'Too Many Requests (RFC 6585)',
+        type: 'errors/defaults/4xx/toomanyrequests'
+    },
+    431: {
+        status: 431,
+        title: 'Request Header Fields Too Large (RFC 6585)',
+        type: 'errors/defaults/4xx/requestheaderfieldstoolarge'
+    },
+    451: {
+        status: 451,
+        title: 'Unavailable For Legal Reasons (RFC 7725)',
+        type: 'errors/defaults/4xx/unavailableforlegalreasons'
+    }
+};

package/esm/defaults/5xx.d.ts

@@ -0,0 +1,57 @@
+export declare const statusCodes: {
+    500: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    501: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    502: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    503: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    504: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    505: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    506: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    507: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    508: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    511: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    510: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/5xx.js

@@ -0,0 +1,58 @@
+// Source: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
+export const statusCodes = {
+    500: {
+        status: 500,
+        title: 'Internal Server Error',
+        type: 'errors/defaults/5xx/internalservererror'
+    },
+    501: {
+        status: 501,
+        title: 'Not Implemented',
+        type: 'errors/defaults/5xx/notimplemented'
+    },
+    502: {
+        status: 502,
+        title: 'Bad Gateway',
+        type: 'errors/defaults/5xx/badgateway'
+    },
+    503: {
+        status: 503,
+        title: 'Service Unavailable',
+        type: 'errors/defaults/5xx/serviceunavailable'
+    },
+    504: {
+        status: 504,
+        title: 'Gateway Timeout',
+        type: 'errors/defaults/5xx/gatewaytimeout'
+    },
+    505: {
+        status: 505,
+        title: 'HTTP Version Not Supported',
+        type: 'errors/defaults/5xx/httpversionnotsupported'
+    },
+    506: {
+        status: 506,
+        title: 'Variant Also Negotiates (RFC 2295)',
+        type: 'errors/defaults/5xx/variantalsonegotiates'
+    },
+    507: {
+        status: 507,
+        title: 'Insufficient Storage (WebDAV; RFC 4918)',
+        type: 'errors/defaults/5xx/insufficientstorage'
+    },
+    508: {
+        status: 508,
+        title: 'Loop Detected (WebDAV; RFC 5842)',
+        type: 'errors/defaults/5xx/loopdetected'
+    },
+    511: {
+        status: 511,
+        title: 'Network Authentication Required (RFC 6585)',
+        type: 'errors/defaults/5xx/networkauthenticationrequired'
+    },
+    510: {
+        status: 510,
+        title: 'Not Extended (RFC 2774)',
+        type: 'errors/defaults/5xx/notextended'
+    }
+};

package/esm/defaults/aws.d.ts

@@ -0,0 +1,12 @@
+export declare const statusCodes: {
+    460: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    463: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/aws.js

@@ -0,0 +1,13 @@
+// Source: https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-troubleshooting.html
+export const statusCodes = {
+    460: {
+        status: 460,
+        title: 'Client closed connection before idle timeout period elapsed',
+        type: '/errors/defaults/aws/clientclosedbeforetimeout',
+    },
+    463: {
+        status: 463,
+        title: 'X-Forwarded-For contains more than 30 ips',
+        type: '/errors/defaults/aws/toomanyips'
+    }
+};

package/esm/defaults/cloudflare.d.ts

@@ -0,0 +1,47 @@
+export declare const statusCodes: {
+    520: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    521: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    522: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    523: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    524: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    525: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    526: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    527: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    530: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/cloudflare.js

@@ -0,0 +1,49 @@
+// Source: https://support.cloudflare.com/hc/en-us/articles/115003011431
+export const statusCodes = {
+    520: {
+        status: 520,
+        title: 'Web Server returned an unknown error',
+        type: '/errors/defaults/cloudflare/unknownerror',
+    },
+    521: {
+        status: 521,
+        title: 'Web server is down',
+        type: '/errors/defaults/cloudflare/webserverdown',
+    },
+    522: {
+        status: 522,
+        title: 'Connection timed out',
+        type: '/errors/defaults/cloudflare/connectiontimeout',
+    },
+    523: {
+        status: 523,
+        title: 'Origin is unreachable',
+        type: '/errors/defaults/cloudflare/originunreachable'
+    },
+    524: {
+        status: 524,
+        title: 'A timeout occurred',
+        type: '/errors/defaults/cloudflare/timeout'
+    },
+    525: {
+        status: 525,
+        title: 'SSL handshake failed',
+        type: '/errors/defaults/cloudflare/sslhandshakefail'
+    },
+    526: {
+        status: 526,
+        title: 'Invalid SSL certificate',
+        type: '/errors/defaults/cloudflare/invalidssl'
+    },
+    // A 527 error indicates an interrupted connection between Cloudflare and your origin's Railgun server (rg-listener)
+    527: {
+        status: 527,
+        title: 'Railgun Listener to origin error',
+        type: '/errors/defaults/cloudflare/railgunoriginerr'
+    },
+    530: {
+        status: 530,
+        title: 'Cloudflare returned 1xxx error',
+        type: '/errors/defaults/cloudflare/1xxx'
+    }
+};

package/esm/defaults/iis.d.ts

@@ -0,0 +1,17 @@
+export declare const statusCodes: {
+    440: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    449: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    451: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/iis.js

@@ -0,0 +1,18 @@
+// Source: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
+export const statusCodes = {
+    440: {
+        status: 440,
+        title: 'Login Time-out',
+        type: '/errors/defaults/iis/logintimeout',
+    },
+    449: {
+        status: 449,
+        title: 'Retry with required information',
+        type: '/errors/defaults/iis/retrywith'
+    },
+    451: {
+        status: 451,
+        title: 'Redirect',
+        type: '/errors/defaults/iis/redirect'
+    }
+};

package/esm/defaults/index.d.ts

@@ -0,0 +1,7 @@
+export { statusCodes as codes4xx } from '../defaults/4xx.js';
+export { statusCodes as codes5xx } from '../defaults/5xx.js';
+export { statusCodes as codesAws } from '../defaults/aws.js';
+export { statusCodes as codesCloudflare } from '../defaults/cloudflare.js';
+export { statusCodes as codesIis } from '../defaults/iis.js';
+export { statusCodes as codesNginx } from '../defaults/nginx.js';
+export { otherErrors } from '../defaults/others.js';

package/esm/defaults/index.js

@@ -0,0 +1,7 @@
+export { statusCodes as codes4xx } from '../defaults/4xx.js';
+export { statusCodes as codes5xx } from '../defaults/5xx.js';
+export { statusCodes as codesAws } from '../defaults/aws.js';
+export { statusCodes as codesCloudflare } from '../defaults/cloudflare.js';
+export { statusCodes as codesIis } from '../defaults/iis.js';
+export { statusCodes as codesNginx } from '../defaults/nginx.js';
+export { otherErrors } from '../defaults/others.js';

package/esm/defaults/nginx.d.ts

@@ -0,0 +1,32 @@
+export declare const statusCodes: {
+    444: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    494: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    495: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    496: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    497: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    499: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/nginx.js

@@ -0,0 +1,33 @@
+// Source: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
+export const statusCodes = {
+    444: {
+        status: 494,
+        title: 'No Response',
+        type: '/errors/defaults/nginx/noresponse',
+    },
+    494: {
+        status: 494,
+        title: 'Request header too large',
+        type: '/errors/defaults/nginx/headertoolarge',
+    },
+    495: {
+        status: 495,
+        title: 'SSL Certificate Error',
+        type: '/errors/defaults/nginx/sslcerterr'
+    },
+    496: {
+        status: 496,
+        title: 'SSL Certificate Required',
+        type: '/errors/defaults/nginx/sslcertrequired'
+    },
+    497: {
+        status: 497,
+        title: 'HTTP Request Sent to HTTPS Port',
+        type: '/errors/defaults/nginx/httpreqtohttpsport'
+    },
+    499: {
+        status: 499,
+        title: 'Client Closed Request',
+        type: '/errors/defaults/nginx/clientclosedreq'
+    }
+};

package/esm/defaults/others.d.ts

@@ -0,0 +1,37 @@
+export declare const otherErrors: {
+    unknown: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    corsError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    problemParseError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    problemJsonError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    notAnError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    networkError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+    inputValidationError: {
+        status: number;
+        title: string;
+        type: string;
+    };
+};

package/esm/defaults/others.js

@@ -0,0 +1,37 @@
+export const otherErrors = {
+    'unknown': {
+        status: 500,
+        title: 'Unknown error',
+        type: '/errors/defaults/others/unknown',
+    },
+    'corsError': {
+        status: 401,
+        title: 'Request not allowed by CORS policy',
+        type: '/errors/defaults/others/corsdenied',
+    },
+    'problemParseError': {
+        status: 1000,
+        title: 'Could not parse problem details',
+        type: '/errors/defaults/others/problemparseerror',
+    },
+    'problemJsonError': {
+        status: 1000,
+        title: 'Could not parse problem JSON',
+        type: '/errors/defaults/others/problemjsonerror',
+    },
+    'notAnError': {
+        status: 1000,
+        title: 'Not an error',
+        type: '/errors/defaults/others/notanerror',
+    },
+    'networkError': {
+        status: 1000,
+        title: 'Network error',
+        type: '/errors/defaults/others/networkerror'
+    },
+    'inputValidationError': {
+        status: 400,
+        title: 'Input failed validation',
+        type: '/errors/defaults/others/validationerror'
+    }
+};

package/esm/index.d.ts

@@ -0,0 +1,5 @@
+export { Problem } from './problem.js';
+export * as defaults from './defaults/index.js';
+export { default as events } from './util/events.js';
+export * from './typings/index.js';
+export * from './util/isProblemArray.js';

package/esm/index.js

@@ -0,0 +1,5 @@
+export { Problem } from './problem.js';
+export * as defaults from './defaults/index.js';
+export { default as events } from './util/events.js';
+export * from './typings/index.js';
+export * from './util/isProblemArray.js';

package/esm/middleware/axios.d.ts

@@ -0,0 +1,13 @@
+import type { PartialMiddlewareOptions } from '../typings/middleware.js';
+import { MiddlewareBase } from './base.js';
+type InterceptorArray = [undefined, (error: unknown) => Promise<never>];
+export declare class AxiosMiddleware extends MiddlewareBase {
+    name: string;
+    constructor(options?: PartialMiddlewareOptions);
+    interceptor: (error: unknown) => Promise<never>;
+    /**
+     * @example instance.interceptors.response.use(...middleware.use())
+     */
+    use: () => InterceptorArray;
+}
+export {};

package/esm/middleware/axios.js

@@ -0,0 +1,20 @@
+import { MiddlewareBase } from './base.js';
+import axiosParser from '../parsers/axios.js';
+import events from '../util/events.js';
+export class AxiosMiddleware extends MiddlewareBase {
+    name = 'axios';
+    constructor(options) {
+        super({
+            'parsers': [axiosParser]
+        }, options);
+    }
+    interceptor = async (error) => {
+        const problems = await this.parse(error);
+        events.emit(problems);
+        return Promise.reject(problems);
+    };
+    /**
+     * @example instance.interceptors.response.use(...middleware.use())
+     */
+    use = () => [undefined, this.interceptor];
+}

package/esm/middleware/base.d.ts

@@ -0,0 +1,24 @@
+import { Problem } from '../problem.js';
+import type { ProblemOpts } from '../typings/index.js';
+import type { MiddlewareOptions, PartialMiddlewareOptions } from '../typings/middleware.js';
+/**
+ * Middleware collects errors from somewhere, transforms them into something recognizable by a parser, and then passes them to the parsers, and then returns an array of Problems to whatever is using the middleware
+ */
+export declare abstract class MiddlewareBase {
+    options: MiddlewareOptions;
+    abstract name: string;
+    /**
+     * When nothing is returned from the parsers, just throw in a default "fallback" Problem object, so that a Problem is still actually returned/emitted
+     */
+    enableFallback: boolean;
+    constructor(defaultOptions: MiddlewareOptions, options?: PartialMiddlewareOptions);
+    /**
+     * Call this function when you want to use the middleware function
+     */
+    abstract use(): unknown;
+    /**
+     * Parse input using parsers
+     */
+    parse: (input: unknown) => Promise<Problem[]>;
+    fallback: ProblemOpts;
+}